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Preface 



About This Book 

Who Should Read This Book 



What’s In This Book 
Contents of the Chapters 



Welcome to Sun Microsystems hardware and software products. This textbook 
is the first edition of a summary and overview of Sun Microsystems’ hardware 
product family, operating system software, application oriented software, and 
technical documentation offerings. 

This book is to help you get acquainted with Sun Workstations and File Servers, 
and to guide you through the available software. 

You should read this book if you are in any or all of these situations; 

□ You’re thinking of buying Sun Workstations and you want to know what’s 
available. 

□ You’ve already bought a Sun Workstation, or your boss has dropped a Sun 
Workstation on your desk, and you don’t know where to start. 

□ You know nothing about the UNIX operating system or any of the Sun 
software. 

□ You know about the UNIX operating system but you want to find your way 
around Sun Microsystems’ rendition of it. 

□ You’ve mn out of bedtime reading material or are consumed by curiosity. 

This book is a guide — a set of signposts if you like — to the general characteris- 
tics of Sun Microsystems’ hardware, software, and documentation. This book 
tells you what’s available and where to look for more information. This book is 
not a tutorial or a ‘how to’ guide for any of the software. 

Chapter 2 — Sun Product Family — supplies an overview of the Workstation 
systems. 

Chapter 3 — Sun Operating System — User Features — discusses the major 
features of the Sun version of the UNIX operating system. 

Chapter 4 — SunView — User Environment — covers the external (user accessi- 
ble) features of the Sun Window system — the User Interface . 

Chapter 5 — Using the Shells — discusses the Shells . The Shell is still the prin- 
cipal command interface to the UNIX system utilities. 
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Preface Continued 



Chapter 6 — User Access and Commands — describes the process of gaining 
access to the system and its applications software. 

Chapter 7 — Working With Files — covers the facilities available to work with 
files and make use of the hierarchical file system. 

Chapter 8 — Communications Facilities — describes the local are network facil- 
ities and the remote communication facilities. 

Chapter 9 — Text Editing and Text Processing — provides a description of the 
major programs for creating, editing, and manipulating text. 

Chapter 10 — Programming Languages — describes the programming 
languages and language tools that ate standard in the Sun system. 

Chapter 11 — Software Development Tools — supplies a picture of the many 
tools available to assist the programmer in debugging and maintaining software. 

Chapter 15 — Document Production — covers the application software oriented 
to producing documents. 

Chapter 16 — System Administration — describes the tools available to the sys- 
tem administrator. 



Existing UNIX users should note that 
the documentation described here 
is Suns’ documentation, which has 
diverged dramatically from the stan- 
dard UNIX system manuals. 



Chapter 17 — Sun Technical Documentation — describes the organization of the 
Sun suite of technical manuals. 

Chapter 18 — Third Party Software — contains pointers to the Catalyst third- 
party software program and to the Sun Users’ Group. 

Chapter 12 — Graphics Tools — describes an overview of Suns’ graphic 
libraries. 



Chapter 13 — Sun Operating System — Internal Features — describes the pro- 
gramming interfaces to the Sun operating system. 
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The Sun Workstation 



Basic Hardware 



Basic Software 




Introduction 



Welcome to your Sun Workstation. If you haven’t ever seen a Sun Workstation 
before or used Sun Microsystems’ version of the UNIX operating system, read 
on. 



Sun Workstations are high-performance bitmapped workstations oriented 
towards applications in engineering, CAD (Computer Aided Design), CAM (Com- 
puter Aided Manufacturing), CAE (Computer Aided Engineering), CAP (Com- 
puter Aided Publishing), graphics, software development, and many more. 

Sun Workstations are built around the Motorola MC68020 and MC68010 family 
of microprocessors. Sun Microsystems have enhanced these computer chips with 
unique memory management hardware to provide demand-paged virtual 
memory. Output is to 19-inch bit-mapped monochrome and color displays hav- 
ing 1 152 by 900 pixels. The display screen has its own memory — the frcune 
buffer to provide high-speed data transfer to the screen. Input is via a modem 
keyboard and a mouse pointing device. 

Sun Workstations mn a heavily enhanced version of the 4.2 BSD UNIX system as 
derived from the University of California at Berkeley. The operating system pro- 
vides support for interprocess communication and local area networking. 

The UNIX system comes equipped with a host of software as a base level pack- 
age. Supported languages are C, FORTRAN 77, Pascal, and Assembler. Many 
tools support software development applications. The UNIX system originally 
evolved in an environment of computer scientists doing research into program- 
ming. Utilities exist for performing statistical text processing and document 
preparation. 

To this base of utility packages. Sun Microsystems have added a User Interface 
package based on overlapping windows, and comprehensive libraries of graphics 
packages to support the more common graphics standards. 

As you read through the test of this book, the various chapters introduce you to 
the ‘flavor’ of what’s available in the system. 
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Sun Product Family 



Sun Microsystems builds two major families of monochrome and color worksta- 
tions, plus rack-mountable systems intended to act as file servers. There is a 
wide choice of peripheral equipment. 

Sun products are built around industry standard chips, bus architectures, and net- 
work architectures: 

□ The Sun-3 product family is a group of 32-bit systems based on the 
Motorola MC68020 CPU chip and the high-speed 32-bit VMEbus. 

□ The older Sun-2 product family (Sun-2/120 and Sun-2/170) are 16-bit sys- 
tems based on the Motorola MC68010 CPU chip and the older Multibus 
(IEEE P796 bus). 

□ The newer Sun-2 product family (Sun-2/ 130 and Sun-2/ 160) are 16-bit sys- 
tems based on the Motorola MC68010 CPU chip and VMEbus. 

□ All Sun Microsystems products communicate via the Ethernet — a 10 
Megabit-per-second coaxial cable local area network facility. 

2.1. Sun-3 Product Family The Sun-3 product family is a group of 32-bit systems based on the Motorola 

MC68020 CPU chip and the high-speed 32-bit VMEbus. 

□ Sun-3 computers come standard with 2 Megabytes of real memory expand- 
able up to 16 Megabytes of real memory. 

□ Sun-3 computers can address up to 256 Megabytes of virtual address space. 
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Sun-3/75M 




The Sun-3/7SM is a standalone monochrome desktop workstation normally sup- 
plied without mass storage devices. 

□ Main memory iiom 2 to 8 megabytes. 

□ All input-output traffic is done across the Ethernet. The Sun-3/75M fiius 
requires other Sun products (such as the Sun-3/ 1 60S or Sun-3/ 1 SOS 
described below) to act as file servers. 

□ Add on mass storage is available for the Sun-3/75M as an option. 

□ The Sun-3/75M has no external bus, unlike the other members of die Sim-3 
family described below. 



Sun-3/160M 





The Sun-3/ 160M is a deskside monochrome workstation based on the VMEbus. 

o 128 Kbyte frame buffer, 
a Upgradable to a color monitor. 

□ The deskside pedestal has a 12-slot VME card cage. 



The Sun-3/ 160C is a deskside color workstation based on the VMEbus. 

□ Eight planes of color. 

□ 256 simultaneously displayed colors, 
o Palette of 2*“* colors. 

□ Main memory available from 2 to 16 megabytes. 

□ Optional hardware includes a graphics processor (GP) and graphics buffer 
(GB). 

o The deskside pedestal has a 12-slot VME card cage. 
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Sun-3/160S 




11 . Sun-3 Optional 
Hardware 



Floating Point Accelerator 



Graphics Board 



The Sun-3/ 1 60S is a deskside file server based on the VMEbus. 

□ Standard system contains 7 1 (formatted) megabytes of mass storage. 

□ Main memory available from 2 to 16 megabytes. 

□ Mass storage can be expanded to 1 .5 gigabytes. 

□ Can handle asynchronous terminals. 

□ The deskside pedestal has a 12-slot VME card cage. 



The Sim-3/180S is a rack-mountable file server based on the VMEbus. 

□ Main memory available from 2 to 16 megabytes. 

□ Standard system contains 130 (formatted) megabytes of mass storage. 

□ Mass storage can be expanded to 1 .5 gigabytes. 

□ Can handle asynchronous terminals. 

□ The rack has a 12-slot VME card cage. 



Optional hardware for the Sun-3 product family includes: 

□ Floating Point Accelerator 

□ Graphics Processor Board 
o Graphics Buffer 

The Floating Point Accelerator board is intended for those applications requiring 
higher floating-point performance than the MC6888 1 offers. The floating-point 
accelerator mns up to four times faster than the MC6888 1 and gives two times 
the performance of a VAX 780 with floating-point accelerator. The floating-point 
accelerator complies with the IEEE 754 version 10 standard for floating point. 
Both 32-bit and 64-bit floating-point operations are supported. 

The graphics board is an optional board available for Sun-3 products and also for 
the Sun-2/ 130 and Sun-2/ 160 workstations. The graphics board provides 
dramatic improvements in graphics response time. Graphics applications using 
the graphics board can render 40,000 2D vectors per second or 25,0(X) 3D vectors 
per second. 
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Graphics Buffer 



2J. Sun-2 Product Family 



Sun-2/50 



Sun-2/120 



Sun-2/170 



Sun-2/160 



Sun-2/130 



2.4. Peripherals 



The graphics buffer is an optional board available for Sun-3 products and also for 
the Sun-2/130 and Sun-2/160 workstations. The graphics buffer augments the 
graphics board and is intended for applications where 3D transformations and 
hidden surface remove is time critical. Using the graphics board/graphics buffer 
combination, graphics applications can shade and remove hidden surfaces of 3D 
polygons faster than 1 million pixels per second. Arbitrary polygons can be 
filled at up to 35 million pixels per second. 

The Sun-2 product family is a group of 16-bit systems based on the Motorola 
MC68010 CPU chip. One model in the Sun-2 family is a standalone desktop 
workstation with no external bus. Two models of the Sun-2 family are based on 
the Multibus. Two models of the Sun-2 family are based on the high-speed 16- 
bit VMEbus. Sun-2 computers some standard with 1 Megabyte of real memory 
expandable up to 4 Megabytes of real memory. Sun-2 computers can address up 
to 16 Megabytes of virtual address space. The Sun-2 product family currently 
consists of these standard offerings: 

The Sun-2/50 is a standalone monochrome desktop workstation that is normally 
supplied without mass storage devices. All input-output traffic is done across the 
Ethernet The Sun-2/50 thus requires other Sun products (such as the Sun-2/ 170 
or Sun-2/ 120 described below) to act as file servers. Add on mass storage is 
available for the Sun-2/50 as an option. The Sun-2/50 has no external bus, unlike 
the other members of the Sun-2 family described below. 

The Sun-2/120 is a deskside monochrome workstation based on the Multibus. 

The deskside pedestal has a 9-slot Multibus card cage. 

The Sun-2/ 170 is a rack-mountable file server based on the Multibus. The rack 
has a 15-slot Multibus card cage. The Sun-2/170 can be expanded to four Mega- 
bytes of real memory. 

The Sun-2/ 160 is a deskside color workstation based on the VMEbus. The desk- 
side pedestal has a 12-slot VME card cage. A Sun-2/ 160 is field-upgradeable to 
a Sun-3/160C. 

The Sun-2/130 is a deskside monochrome workstation based on the VMEbus. 
The deskside pedestal has a 12-slot VME card cage. A Sun-2/ 130 is field- 
upgradeable to a Sun-3/ 160M. 

Peripherals that may be attached to Sun systems include SMD disks of various 
sizes ranging from 84 Megabytes to the 474 Megabyte ‘Eagle’ disk, nine-track 
tape, Vi-inch cartridge tape, SCSI disks and tapes. 
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Sun Operating System — User Features 



Sun Microsystems provides its own enhanced version of the UNIX operating sys- 
tem as the basic operating software to exploit the resources of Sun hardware pro- 
ducts. Sun’s operating system is derived from the 4.2BSD system developed for 
the DEC VAX at the Uniersity of California at Berkeley. 4.2BSD was in turn 
derived from UNIX system version 32V developed at Bell Laboratories to use the 
DEC VAX hardware. The 4.2BSD system runs at approximately 5000 VAX sites. 
Although the Sun hardware is microchip based instead of being a VAX, the Sun 
hardware has many features in common with the VAX architecture and so many 
of the same strategies can be employed in the operating system. 

3.1. Hierarchical File System The most visible aspect of the operating system is the file system — the facility 

that you use to store and retrieve data. At the user (command) level, the basic 
object on which you can operate is a file . A file is a collection of data with 
several attributes, the most important being its name . 

The hierarchical file system provides the means to group related files within a 
directory . A directory is itself simply a special case of a file, which means that a 
directory can contain other directories as well as files. Directories can be 
grouped within directories to arbitrary limits in the Sun Microsystems operating 
system. Here is a representative picture of a file system containing directories 
and files for both the system and several users: 
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3^. The Hierarchical File Sun Microsystems have taken the idea of file systems a major step furdier with 

System in the Network the Network File System . The Network File System (NFS) is a facility for shar- 
ing files in a heterogeneous environment of machines, operating systems, and 
networks. Sharing is accomplished by mounting a remote filesystem, then read- 
ing or writing files in place. The network file system avoids die problem of each 
node in a network maintaining its own file systems and thereby duplicating 
resources. 

In the network file system, a file system does not need to be physically present on 
your local disk or on your own areas on your server. Now you can mount file 
systems from other machines in the network as well as from disks attached to the 
local machine. Once a remote file system is mounted, it appears to be a part of 
the existing file system hierarchy. 

Figure 3-2 below shows three workstations with their public / usr file systems 
mounted from a NFS server. All file trasnfers take place over the Ethernet. 
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Figure 3-2 Network File System 




A machine that provides resources to the network is a server , while a machine 
that employs these resources is a client . A machine may be both a server and a 
client. A person logged in on a client machine is a user , while a program or set 
of programs that run on a client is an application . 

The network file system is Sun Microsystems’ first and very major step towards 
addressing the issues of heterogeneous networks of resources. 

Yellow Pages Network Service The Yellow Pages (YP) is a network service to ease the job of administering 

networked machines. The YP is a centralized read-only database. For a client on 
the network file system, this means that an application’s access to data served by 
the YP is independent of the relative locations of the client and the server. The 
YP database on the server provides password, group, network, and host informa- 
tion to client machines. 
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3 User Interface — The user interface based on the Sun window system (SunView) is described in 

Window System more detail later on. Briefly, flie user interface is based on multiple overlapping 

windows on the screen to provide the ‘desktop’ metaphor. Instead of typing 
commands, you manipulate objects in the user environment via a pointing device 
called a mouse. 

Figure 3-3 Workstation Screen with Overlapping Windows 




3.4. C-Shell — Command The Shell is the command interpeter for UNIX systems. The Shell is the princi- 

Interpeter pal command-oriented interface to the operating system and utilities outside of 

the window- and mouse-based user interface. The Shell responds to user com- 
mands and arranges to run the appropriate utility software on the user’s behalf. 
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On Version 7 UNIX systems, the ‘standard’ Shell is the Bourne Shell named for 

S. R. Bourne, its creator. 

The C-Shell was implemented by William N. Joy at the University of California 

at Berkeley. The C-Shell is a powerful interactive command interpreter. Here 

are some of the C-Shell ’s major features: 

□ Jobs can be mn in the background and brought to the foreground. The C- 
Shell can display the status of jobs. 

o The C-Shell can maintain a history of user commands both during a login 
session and across login sessions. You can display the history list and refer 
to previous commands either by their event number or by the first few 
unique characters of the command. You can make substitutions to repeated 
commands. 

□ You can tailor your command set by using the C-Shell alias facility — a 
macro-like facility to provide synonyms for commands. 

□ You can tailor your command environment by using the C-Shell profile 
facilities where you can set standard aspects of the environment such as 
where the Shell searches for commands. 

□ The C-Shell can be used as a programming language — you can place 
sequences of commands in a file and get the command sequences executed 
just by typing the name of the file. The programming features of the Shell 
can be used to perform often complex tasks without the need to write 
software. 
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Window User Interface 



SunView — User Environment 



Sun Microsystems window-based user environment exploits the capabilities of 
the high-resolution bit-mapped screen in SunView — the Sun Visual/Integrated 
Environment for Workstations. 

SunView is two things; 

□ A user interface accessible via the suntools package which provides 
multiple overlapping windows on die screen. Each window runs user tasks 
independent of the other windows on the screen. 

□ SunGuide — Sun General User Interface Design Environment — is a pro- 
gramming interface accessible via a collection of subroutine libraries. 

There are three major levels of abstraction in the programming interface to 
SunView, and a programmer can use any or all of diese three layers to write 
applications. 

This chapter concentrates on die external (user accessible) features of SunView. 

The user interface of SunView is a collection of software utilities that exploit the 
graphical capabilities of the Sun hardware. The mouse (a pointing device) is a 
primary mechanism for interacting with die tools. The emphasis is on ‘point at 
what you want’ rather than on ‘type a command and wait for a response’. In 
many applications the mouse is superseding die keyboard as the communication 
channel. Application software displays control panels with buttons that you 
‘push’ with the mouse, and sliders (potentiometers) that you adjust with the 
mouse. 
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Figure 4-1 User View of the Sun Window System 




Windows occupy sections of the screen and can overlap each other. You can 
move windows around on the screen. You can bring a window to the top of the 
heap by point at it, or send a window to the bottom of the pile. You can adjust 
the size of a window depending on the needs. You can ‘close’ a window so that 
it occupies a minimum amount of the real-estate on the screen. When a window 
is closed it becomes an ‘icon’ — a small graphical object whose appearance 
sometimes suggests its function. Figure 4-2 is a picture of a typical screen with 
three overlapping windows and some icons. 
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Figure 4-2 Typical Screen with Overlapping Windows and Icons 
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|orpheus% If 
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not found. 








lorpheusX alias If Is 
lorpheusX alias If Is -CF 








lorpheus% If 
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system . i nterf ace .man/ 
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pc . shp 
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acad.cfg 
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test. dug 
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old. ditroff/ 


transfer/ 







Bl 



You ‘select’ things by pointing at them with the mouse. One application is to 
select text in one window and ‘stuff’ it into the input stream of another window 
— this forms the basis of ‘cut and paste’ style editing. 

See Windows and Window-Based Tools — Beginner’ s Guide for detailed 
descriptions on using SunView and its applications. 
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Using the Shells 



shelltool is the window tool to provide a window-based interface to the stan- 
dard UNIX system command interpreters (shells). 
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I.BP 

BYou know nothing about the 
I.UX 

Joperating system or any of the Sun software. 

|.BP 

If/ou know about the 
.UX 

Ijoperating system but you want to find your way around Sun Microsystems' 
Irendition of it. 

.BP 

If/ou've run out of bedtime reading material or are consumed by curiosity. 

.UH H "Vhat's In This Book" 

.LP 

I This book is a guide \(em a set of signposite if you like \(em to 
[the general characteristics of Sun Microsystems' hardware, software, and 
documentation. This book tells you 
.1 "what's available" 

Band where to look for more information. This book is 
.1 not 

Ha tutorial or a '‘how to' guide for any of the software. 

.UH H "Contents of the Chapters" 

.LP 

IlChapter 

”.XR eNumberOf(Sun_Product_Fami ly) \(em \fI@TitleOf (Sun_Product_Fami ly)\fP \(em 
supplies an overview of the Workstation systems. 

.LP 

J"preface.mexp" 131 lines, 4486 characters 
Uangel% preview overview. dit 
]angel% ! ! 

llpreview overview.dit 
jangeU Is -1 !$ 

Is -1 overview.dit 
-rw-rw-r — 1 henry 

[angel^ Iprev 
preview overview.dit 
angel% date 

Sun Jan 12 19:27:37 PST 1986 
angel% screendump > preview. screen 
angel% ! ! .grid 

screendump > preview. screen. grid 
angelX pssun -2 preview. screen | Ipr -Plyle 
angel% !dits:p 
dits: Event not found. 

angel% pssun -2 preview. screen. grid 1 Ipr -Plyle 
angel% screendump > shell. screen 



148745 Jan 12 19:23 overview.dit 



gures.di t 



index. dit 



pagi 



Bieus 



Total Size 
301056 bytes 
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Debugging Software dbxtool is a window-based interface to the capabilities of dbx — the sym- 

bolic debug utility. Using dbxtool, you point at the object you wish to operate 
on (say display the value of a variable) and then you ‘push a button’ to get the 
operation done. Here is a picture of a dbxtool window with the program’s 
source code displayed in one window and the commands displayed in another 
window: 

Figure 4-4 Debugging a Program Using the Interactive Debug Utility 



S 3.0: /bin/csh 












pbxtool 












Awaiting Execution 

File Displayed: ./print. index. c 










Lines: 18-39 



struct ind 0 x_entry 



•node; 



if (node == NULL) 
return; 

pri nt_i ndex(node*->l esser ) ; 
pr i nt_node(node, previ ous_i ndex_entry ) ; 
f prgvious_index_entry = node; 
print_index(node->greater); 



/* 

* Print out an Index entry 
*/ 

print_node(node, previous) 
struct index_entry *node; 

struct index_entry *previous; 

{ 



int 



level ; 



Reading symbolic information... 

Read 787 symbols 
(dbxtool) func print_index 
(dbxtool) stop in print_node 

(1) stop in print_node 
(dbxtool) print index_entry 
can''t evaluate a typeid 
(dbxtool) print node 
"node" is not active 

(dbxtool) stop at "print. index. c" :26 

(2) stop at "print . index. c" :26 
(dbxtool) 



See Debugging Tools for the Sun Workstation and the dbxtool(l) and dbx(l) 
manual pages for further details. 
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Displaying the Time 

clockt ool displays the date and time in the form of a clock on the screen. 
The display can be customized in various ways; 

a round or square clock, 

□ Arabic or Roman numerals on the clock face, 

□ display the seconds, 

□ display the day of the week. 

See Windows and Window-Based Tools — Beginner’s Guide and the clock- 
tool(l) manual page for further details. 
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Editing Text 



textedit is a mouse-based text editing utility. There are mouse functions to 
select regions of text, arai the function keys can be used to perfoim cut and paste 
operations. 



Figure 4-5 Text Editing Utility 




File: input out .msun; directory: /usr/doc/language .manuals/pascal .manuals 



frtmat.TDsun preface. nisun basics. msun errors. msun inputout.msun components.msun 
Cal 1 ing . Pascal . From. Other . Languages Cal 1 ing. C . from . Pascal Cal ting . F77 . from . Pascal 
ext .msun grammar, msun wirthappendix.msun biblio.msun manual, pages 

user-defined 

.\” SMI; Put into SCCS 12 August 1984 

.so pageHeader.msun 
.PL RIGHT 

.H C "Input and Output" 

.so pageFoo ter .msun 
.LP 

This chapter describes features of the Pascal input/output 
environment, with special consideration of the features specific to 
interactive programs. 

.H 2 "Introduction" 

.LP 

In Sun Pascal, the predefined file variables \fLinput\fP and 
\fLout put\fP are equivalent to the UNIX standa rd input and output 
files Consequently, Pascal 



I 
I 



MM 



programs can be easily used in the UNIX environment to read or 
write files by usings the shell to redirect \fLstdin\fP and 
\fLstdout\fP. For example, consider the following progr^^ 
which copies input to output: 



program copy ( input , output ) ; 

var c: char; 

begin 

while not eof to begin 
while not eoln do begin 
read(ch); 
write(ch); 
end; 
readln; 

writeln; \ 

end; 
end. 

.LE 

.BE 

Assume that the program above is saved in a file called \fLcopy.p.\fP 
First, you would compile it and produce a program called \fLcopy\fP 
as follows: 

.BS 

.LS 

hostname% \f(LBpc copy.p -o copyXfP 

.LE 

.BE 



See Windows and Window-Based Tools — Beginner' s Guide for further details. 
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Creating Fonts f ontedit creates and edits fonts. You load up a font and select a portion of 

that font to be displayed in the eight small windows. Two characters at a time 
may be selected for editing. The characters to be edited are displayed in large 
format and you can make pixel-by-pixel modifications to the characters. 

Figure 4-6 Font Editing Utility 




See Windows and Window-Based Tools — Beginner’s Guide and the f on- 
tedit(l) manual page for further details. 
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Reading Mail 



mailtool is a window and mouse based interface to the standard mail reading 
utility. You can use the standard text facilities of SunView to compose messages 
and move text between messages. 

Figure 4-7 Mail Utility 
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lailtool - folder: /usr/ti tan/henry/mbox 






n tutecairo 


Fri 


Nov 


15 


16:36 


124/4098 


2 


swagman ! swagman 


Tue 


Nov 


19 


18:47 


66/2302 


3 


sevansSwindow 


Fri 


Nov 


22 


15:33 


38/1392 


4 


sunukigary 


Tue 


Nov 


26 


13:25 


28/1085 


5 rdh0orpheus 


Tue 


Dec 


3 


14:05 


54/1866 


6 


tut@cairo 


Thu 


Dec 


5 


13:42 


34/1445 


7 


denal i !bi 1 1 


Mon 


Dec 


9 


14:13 


106/2873 


8 


dshrQdevnul 1 


Ved 


Dec 


11 


12:42 


109/3026 


9 


roberto0sunstorm 


Sun 


Dec 


15 


00:03 


133/3393 


10 


dirk0words 


Mon 


Dec 


16 


08:59 


123/6216 



/usr/doctools and device- 
Re: signals to semaphore 

Re: multiple siguinches 

Determining source of SIG 
applications and signals 
FYI 

Re: Vindou Dumping 

Andrew 

windows: in 3.0Pilot - LO 
Planning A Book Design fo 



show ][ next ~][ delete ][undelete][ print ][new main[ done 

( commit" 



I reply *][ compose^ 

[ save copy i File: /usr/ti tan/henry/mbox 

m [ folder 1 



From tutecairo Fri Nov 15 16:36:14 1985 

1?eceived: from Cairo. sun. uucp by angel .sun. uucp (3.0DEV2/SMI-3.0DEV3) 
id AA02060; Fri, 15 Nov 85 16:36:09 PST 
Return-Path : <tu t@ca i ro> 

Received: by cairo. sun. uucp (3.0DEV2/SMI-2.0) 

id AA03456; Fri, 15 Nov 85 16:02:24 PST 
Date: Fri, 15 Nov 85 16:02:24 PST 
From: tut@cairo (Bill Tuthill) 

Message-Id : <8511160002 . AA03456@ca1 ro . sun . uucp> 

To: software-orgQcairo 

Subject: /usr/doctools and device-independent troff 
Status: RO 

This note tells you how to use device-independent troff (di troff) 
and its related pre-processors on the Engineering network. Tech 
Pubs uses these tools to produce Sun"s manuals. If you write 
documents to give to Tech Pubs, we appreciate getting troff text 
containing -ms macros. It^'s helpful if you put non-English words 
(such as program and function names) in italics or listing font. 

First you need to remote mount /usr/doctools from titan. Put this 
line in your /etc/fstab file, and invoke the mount command: 

# cat » /etc/fstab 

titan: /usr/doctools /usr/doctools nfs ro,soft 0 0 

# mount /usr/doctools 

Because the new formatting tools have the same names as outmoded 
ones in /usr/bin, /usr/doc tool s/bin must precede /usr/bin in your 



See Mail andMessages — Beginner’s Guide and the mail(l) manual page for 
further details. 
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Setting up Defaults 



Many UNIX system utilities use files of user-created parameters to control their 
actions, def aultedit brings these scattered environment files into a single 
tool that can create and edit the parameters. 

Figure 4-8 Default Editing Utility 



Indent Defaults 



Indentation: 8 spaces 
Indent variables: 16 colimns 
Line length: 75 chars 
Current File: 

[ load j (format j (save] 



Case labels: align uiith suitch 
Trailing comments start in column: 33 
Typedefs: 

Directory: /usr/ti tan/henry 
[save options] (default options^ (reset options] 



1^1 Formatting. . . 



mainO 
{ 



printf ("He! lo Vorld!\n"); 






See Windows and Window-Based Tools — Beginner* s Guide for further details. 
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Using the Shells 



Other than the user interface provided by the Sun window system, one of the 
principal means of getting the system to do work for you is by typing commands 
to the Shell . The Shell is the system’s command interpreter . Early in the 
development of the UNIX system, the idea arose of having a single command 
interpreter to provide a more coherent command interface to the user than would 
have been provided had every command done its own analysis of the command 
line. 

There are two main Shells in use on the Sun operating system: 

o the C Shell is the command language interpreter written at the University of 
California, Berkeley. 

□ The Bourne Shell (named after S. R. Bourne) was the standard UNIX system 
Version 7 Shell. 

There are many similarities in the user interface the two Shells provide. The 
major external differences between the two Shells are that the C Shell provides 
job control and history. Other major differences are largely internal to the Shells 
in the area of their programming interface. 

5.1. External Features of the Major features that both Shells provide to the user interface are: 

Shells 

a Analyse the command line. Run the indicated command, passing the 
remainder of the command line as arguments to the command. The Shell 
runs each command as a separate process . Such a process can be run ‘while 
you wait’, in the foreground , or a command can be run in the background , 
so that the Shell returns immediately and you can continue typing more 
commands. 

□ Redirect the standard input, standard output, and standard error files of the 
command as defined by the user. 

□ The Shell can arrange that the standard output of one process is connected to 
the standard input of the next process in line. Multiple processes can be con- 
nected together in this way. Such a connection is called a pipeline , obviat- 
ing creating and managing temporary files. 

□ Filename expansion. Both Shells provide some metacharacters to indicate 
aggregates of files. An aggregate of files is said to be matched if there are 
metacharacters in the specification. The ? metacharacter matches any 




35 



A of 15 February 1986 




36 System Overview 



single character in a filename. The * metacharacter matches any string of 
characters (including die empty string) in a filename (so that, for instance, * 
on its own matches all files in a directory. The [ and ] metacharacters form 
character classes that indicate ranges of letters or digits in filenames, so 
that, for instance, [a-m] * means all files starting with the letters a through 
m. 

□ Both Shells provide user-settable search path for finding commands. Both 
Shells provide can execute a user-settable profile upon login. The profile is 
used to ‘tailor’ your envirorunent to your special needs. 

Both Shells can be used as a programming language. Collections of Shell com- 
mands can be placed in a file and the filename typed just like any other system 
command. Shell scripts as they are called provide the advantage that you don’t 
need to run a compiler and loader and recompile to change things. Shell scripts 
frequently provide a good first cut at an application by using the Shell program- 
ming features in conjunction with coimecting existing UNIX system commands 
together. Shell scripts provide for what is often called rapid prototyping or 
instant gratification. 

Programming features that are common to both Shells include: 

□ Set and access variables. 

□ Substitute arguments from the command line. 

□ if... then ... else constucts for conditional execution of commands. 

□ case switches for selecting groups of commands. 

□ while loops for to execute groups of commands iteratively. 

□ for loops for executing groups of commands over lists of files or variables. 
D break, continue and exit to get out of looping constructs. 

□ Take special action on traps and interrupts. You use these features so that 
you can do ‘clean up’ action if a Shell process is interrupted. 

5 The Shells Shells available on the Sun operating system include the C Shell, the Bourne 

Shell, and the Remote Shell. 



5.2. Programming Features of 
the Shells 



C Shell 



csh is the C Shell. Users normally access csh when they use a Sun system — 
the Bourne Shell is less frequently used. The C-Shell is the command language 
interpreter written at the University of California, Berkeley as part of die 4.2 
BSD operating system upon which Sun Microsystems bases their standard oprtat- 
ing system. 

The C Shell provides a flexible user interface. Its major external features are: 

□ A history facility for reissuing previous commands. The Shell maintains a 
history buffer of the last n commands, where n is specified by the user. You 
can display the history list You can refer to commands in the history list by 
their event number in the list or by searching for substrings of the actual 
name of the command. There are many other aspects to this feature. 

□ Job control. You can runjobs in the background or the foregroimd. Fore- 
ground jobs can be sent to the background and background jobs can be 
brought to the foreground. You can find out what jobs are ranning and kill 
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Remote Shell 



Bourne Shell 



5.4. Shell Related Utilities 



Displaying Command Line 
Arguments 



Conditional Testing 



them if required. You can suspend a foreground job, do somthing else, then 
resume the foreground job. 

□ An alias mechanism. You can define an alias for firequendy typed com- 
mands. 

o A history substitution mechanism . In conjunction with the history mechan- 

ism described above, you can substitute parts of previous commands either 
single-shot, or globally. 

o Optionally announce the presence of mail as mail arrives in the system. 

The major programming features of the C Shell include: 

o The syntax of Shell commands resembles the C programming language, 
whereas the Bourne Shell resembles Algol-68. 

□ Compose compound commands using the programming constructs described 
above in the general discussion. 

See Doing More with UNIX — Beginner’s Guide and the csh(l) manual page 
for further details. 

rsh is the remote Shell — you can execute a command on another system. The 
remote Shell looks just like the regular Shell in that you can connect the output 
of rsh to another process on your own machine via a pipe. 

See the rsh(l) manual page for further details. 

sh is the Bourne Shell, the UNIX system version 7 command language inter- 
preter. The Bourne Shell is named after S. R. Bourne of Bell Laboratories. The 
Bourne Shell has most of the same external features as the C Shell. The Bourne 
Shell lacks the history facility, the job-control facility, and the history substitu- 
tion facility. Its internal programming features are modelled after the Algol-68 
programming language. One school of thought maintains that writing Shell 
scripts is easier with the Bourne Shell. 

See Doing More with UNIX — Beginner’s Guide and the sh(l) manual page for 
further details. 

By themselves, the Shells do not attempt to do everything — that is against the 
philosophy of the system. Instead, the Shells call on the services of some other 
utilities that do specialized jobs. 

echo displays the remainder of its command line, echo is useful for diagnos- 
tics or prompts in Shell programs, or for inserting data into a pipeline. 

See Doing More with UNDC — Begirmer’s Guide and the echo(l) manual page 
for further details. 

test tests for use in Shell conditionals. Some of its features include: 

□ String comparison 
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Evaluating Expressions 



Waiting on Process 



Suspending Execution 



Blocking Hangups 



Changing Priority 



Killing Processes 



Scheduling Actions 



Diverting Output 



□ Detennine the nature of a file (is it a directoiy, file, link, symbolic link, and 
so on), and the file’s accessibility (is it readable, writeable, executable, and 
so on). 

o Boolean combinations of the above. 

See Doing More with UNIX — Beginner’s Guide and the test(l) manual page 
for further details. 

expr evaluates expressions that appear on its command line as arguments. 
Some of its features include: 

□ String computations 

□ Integer arithmetic 

□ Pattern matching. 

See Doing More with UNIX — Beginner’s Guide and the expr(l) manual page 
for further details. 

wait waits for termination of asynchronously mnning processes. 

See the wait(l) manual page for further details. 

sleep suspends execution for a specified time. 

See the sleep(l) manual page for further details. 

nohup is mainly used for dialup lines. It runs a command immune to hanging 
up the telephone. 

See the nice(l) manual page for further details. 

nice runs a command in low or high priority. 

See the nice(l) manual page for further details. 

kill terminates specified processes or jobs. 

See Doing More with UNIX — Beginner’s Guide and the kill(l) manual page 
for further details. 

at schedules a one-shot action for an arbitrary time. 

See Doing More with UNIX — Beginner’s Guide and the at(l) manual page for 
further details. 

tee passes data between processes and diverts a copy into one or more files. 

See Doing More with UNIX — Beginner’s Guide and the tee(l) manual page 
for further details. 
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Gaining Access to the System 



Changing Your Password 



Logging Out 



User Access and Commands 



Access to the Sun operating system is via a system of user accounts and optional 
passwords . You can log in to your local workstation, and once logged in, you 
can remotely log in to other systems using rlogin. Access to remote hosts in 
geographically remote areas can be gained via tip described in chapter 8 — 
Communications Facilities. 

login is the command to gain initial access to the system. 

□ Sign on as a new user 

□ Verily password and establish user’s individual and group (project) identity 

□ Adapt to characteristics of a terminal 
D Establish working directory 

□ Announce presence of mail 

□ Publish message of the day 

□ Execute user-specified profile 

D Start command interpreter or other initial program. 

See Getting Started with UNIX — Beginner’s Guide and the login(l) manual 
page for further details. 

passwd establishes your initial password or changes an existing password 

□ Users can change their own passwords 
o Passwords are encrypted for security. 

See Getting Started with UNIX — Beginner’s Guide and the passwd(l) manual 
page for further details. 

logout logs you out of the system. You can execute an optional . logout file 
containing cheery ‘goodbye’ messages, or making your screen dark, or some 
such. 

See Getting Started with UNIX — Beginner’s Guide and the logout(l) manual 
page for further details. 
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6.1. Useful Commands 



Displaying Date and Time 



Finding Out Who is Logged In 



Displaying What is Going On 



Logging into Another Machine 



Running Commands on Other 
Machines 



Reminder Service 



Calculators — dc 



The remainder of this chapter describes some small and suefiil commands. 
Chapter 7 — Working With Files — discusses files, directories, and the com- 
mands that operate on them. 

date displays today’s date and time, date has considerable knowledge of 
calendric and horological peculiarities. The super-user can use date to set sys- 
tem date and time. 

See Getting Started with UNIX — Beginner’s Guide and the date(l) manual 
page for further details. 

who lists presendy logged in users, ports and login times. Provides optional his- 
toiy of all logins and logouts. 

The w command is a Berkeley enhancement that displays what command people 
are running as well as who is logged in. 

See Getting Started with UNIX — Beginner’s Guide and the who(l) and w(l) 
manual pages for further details. 

ps displays active processes 
o list your own or everybody’s processes 

□ and provide optional status information: state and scheduling info, priority, 
attached terminal, what process is waiting for, and size. 

See Doing More with UNIX — Beginner’s Guide and the ps(l) manual page for 
further details. 

rlogln logs you in to another machine in the local network. 

See Mail and Messages — Beginner's Guide and die rlogin(l) manual page 
for further details. 

rsh executes a shell on a remote host in the local network. 

See Mail and Messages — Beginner’s Guide and the rsh(l) manual page for 
further details. 

calendar provides an automatic reminder service for events of today and 
tomorrow. 

See Getting Started with UNIX — Beginner’s Guide and the calendar(l) 
manual page for further details. 

dc is an interactive programmable desk calculator 

o Has named storage locations as well as conventional stack for holding 
integers or programs 

□ Unlimited precision decimal arithmetic 

o Appropriate treatment of decimal fractions 
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□ Arbitrary input and output radices, in particular binary, octal, decimal and 
hexadecimal 

□ Reverse Polish operators: 

H * / 

remainder, power, square root, load, store, duplicate, clear, 
print, enter program text, execute. 

See Games, Demos, and Other Pursuits — Beginner’s Guide and the dc(l) 
manual page for further details. 

Calculators — be be is a C-like interactive interface to the de desk calculator described above 

o be has all the capabilities of de with a high-level syntax 
o Arrays and recursive functions 

□ Immediate evaluation of expressions and evaluation of functions upon call 

□ Arbitrary precision elementary functions exp, sin, cos, atan 

□ Go-to-less programming. 

See Games, Demos, and Other Pursuits — Beginner’s Guide and the be(l) 
manual page for further details. 
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Working With Files 



What is a Filet 



What is a Directoryt 



Manipulating Files and 
Directories 



Access Permissions 



J^file is the principal vehicle for organizing and operating on information in the 
system. The hierarchical file system is one of the Sun operating system’s major 
strengths. 

A file is a collection of data in some container somewhere. A file has several 
attributes in the Sun operating system — the major and most important attribute 
being the name of the file. Other attributes include the access permissions, size, 
the date and time the file was created, and the date and time the file was last 
changed. 

A file resides in a directory . A directory is simply a special kind of file that has 
the property of being able to ‘contain’ other files and directories. Since a direc- 
tory can contain other directories, the hierarchy can in principle extend to unlim- 
ited depth. 

The Sun operating system attempts to treat just about every object in the system 
as a file. For example, the physical memory of the computer can be accessed and 
manipulated like a file. 

There are two broad classes of utilities that operate on files and directories: 

□ One class of programs creates, removes, and renames files and directories. 

□ The other class of programs copies and manipulates the contents of files and 
directories. 

In general, you might think of the first class of programs as manipulating the 
attributes of files and directories, while the second class of programs is for mani- 
pulating the data stored in the containers. 

When you create a directory or file, one of its attributes is its access permissions 
— who can access the directory or file, and what operations they can perform. 
The access permission are called the mode of the file in UNIX system jargon. 
Three types of users are recognized as being able to access a directory or file: 

□ The owner — the person who originally created the directory or file, 
o The group — the group of users to which the owner belongs. 
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Working Directory 



Home Directory 



□ The public — eveiybody else other than the owner and the members of the 
owner’s group. 

For each type of users, there are three kinds of access to a directory or file, 
namely: 

read the user can look at the contents of the file or can look inside the 

directory, 

write the user can change the contents of the file or can create other direc- 
tories or files inside a directory, or 

execute the user can type the name of the file as a command to the system or 
can perform certain operations that involve traversing through the 
directory. 

You can change directory so that you are ‘positioned’ at a given place in the file 
system hierarchy. The place where you are positioned is called the current direc- 
tory or the working directory . 

When your new user account is created, you are also given an initial working 
directory. You are ‘positioned’ at this directory when you log in. This initial 
directory is called your home directory. 

Figure 7-1 below shows the commonly used commands that operate on files and 
directories. 
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Figure 7-1 Common Operations on Files and Directories 




7.1. Managing Files and 
Directories 



A simple file is created simply by mentioning its name in some operation such as 
cat (described later), or using one of the system text editors described in chapter 
9. A directory must be created by a special command. 



Finding Out What Files You Is displays the names of files and directories. A plain Is command just 

Have displays a list of files sorted in alphabetical order. You can alter the display in 

may ways: 

o reverse alphabetical order 

□ by time of last access 

o mark the display showing directories distinct from files and mark executable 
(program) files. 

□ optional information via a ‘long listing’ format — size, owner, group, date 
last modified, date last accessed, permissions, i-node number. 

See Doing More with UNIX — Beginner’s Guide and the ls(l) manual page for 
further details. 
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Changing Working Directory 



Finding Out Where You Are 



Creating a New Directory 



Removing a Directory 



Changing Access Permissions 



Changing Group Ownership 



Moving and Renaming 



You use the cd command to change your working directory (‘position’ yourself) 
to a specified place in the directory hierarchy. 

If you type a cd command without any specified directory name, you get back to 
your home directory. 

See Doing More with UNIX — Beginner’s Guide and the cd(l) m anual page for 
Anther details. 

When you need an answer to the question ‘where am I?’ in the directory hierar- 
chy, you use the pwd (print name of working directory) to display the name of 
your working directory. 

See Doing More with UNIX — Beginner’s Guide and the pwd(l) manual page 
for further details. 

mkdir makes a new directory. 

See Doing More with UNIX — Beginner’s Guide and the mkdir(l) manual 
page for further details. 

rmdir removes a directory from the file system. The directory must be empty 
(contain no files or other directories) before it can be removed. 

See Doing More with UNIX — Beginner’s Guide and the rmdir(l) manual 
page for fiirther details. 

chmod changes the mode (the access permissions) on one or more files. Only 
the owner of the file, or the super-user, can use the chmod command. 

See Doing More with UNIX — Beginner’s Guide and the chmod(l) manual 
page for further details. 

Users can be placed together in groups (loosely associated with a project) in the 
system. When files are created they are associated with a group as well as an 
owner, chgrp changes the group (project) to which a file belongs. 

See Doing More with UNIX — Beginner’s Guide and the chgrp(l) manual 
page for forther details. 

mv moves a file or files from one place to another in the directory hierarchy, mv 
has the side effect of being able to rename files or directories. Why is this? You 
can move a file from one place to another ^ the destination name can be dif- 
ferent from the source name, so moving a file with different source and destina- 
tion names within the same directory effectively renames the file without ‘really’ 
moving it. mv can also move whole directory hierarchies from place to place in 
the file system. 

See Doing More with UNIX — Beginner’s Guide and the mv(l) manual page for 
further details. 
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Making Links 



Removing Files and Directories 



Finding Specified Files and 
Directories 



Display Statistics of File System 



12. File Manipulation 
Facilities 



Determining the Type of a File 



You can make a ‘link’ or an ‘alias’ to an existing file using the In command. 

o Flard links can only be created within a file system and make a real physical 
link in the structure. 

o Symbolic links are more like a macro or string substitution and can span file 
systems. The difference between the two kinds of links becomes very 
apparent when removing files, as descibed below. 

See Doing More with UNIX — Beginner’s Guide and the ln(l) manual page for 
further details. 

rm removes files (and directories with special options). The rmdir command 
removes directories. 

o Only the name of the file goes away if any other names are linked to the file 
— this is an important effect of symbolic links as discussed above — you 
can end up with a symbolic link that doesn’t point to anything. 

□ rm can step through a directory deleting files interactively — asking you if 
you want to delete the file 

□ With a special -r (recursive) option, rm can delete entire directory hierar- 
chies. 

See the rm(l) and rmdir(l) manual pages for further details. 

find prowls the directory hierarchy finding every file that meets specified cri- 
teria. Any directory may be considered to be the root or starting place for the 
search, find can be asked to perform specified operating system commands on 
each file that matches the specified criteria. Criteria include: 

□ filename matches a given pattern, 

□ creation date in given range, 

o date of last use in given range, 

□ given permissions, 

D given owner, 

□ given special file characteristics, 

□ Boolean combinations of above. 

See the f ind(l) manual page for further details. 

df displays the amount of free space on file systems. 

du displays a summary of total space occupied by all files in a hierarchy. 

See the df (1) and du(l) manual pages for further details. 

Commands described in the last section concentrated on creating directories and 
files and manipulating their attributes. Now we get to some of the command for 
manipulating the contents of files and directories. 

file determines what kind of information is in a file by consulting the file sys- 
tem index and by reading the file itself. The file command can determine, 
among many others, that a file is one of: 
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Concatenating Files 



Copying Files and Directories 



Remote Copy 



Browsing Through File 



Binary Compare 



□ ASCII text — a plain text file. 

□ Directory — a repository of other files. 

□ Troff, nroff, or eqn input text — input for one of the text formatting pack- 
ages described in chapter 15. 

□ C program text — Source code for the C programming language, file can 
also perform this determination for FORTRAN program text 

□ Executable file (one that has been compiled by one of the compilers) 

See the f ile(l) manual page for further details. 

cat is one of the simplest UNIX system conunands. cat stands for ‘catenate’ 
and its basic operation is to concatenate one or more files together (join them end 
to end) and place the result onto the standard output cat has a variety of every- 
day uses: 

□ Inserting data into a pipeline, 

□ Can optionally display non-printing characters, 

□ Can optionally number lines, 

□ Buffering output that comes in dribs and drabs. 

cat works on any file regardless of contents. 

See the cat(l) manual page for further details. 

cp copies files (and optionally whole directory hierarchies) from place to place. 

□ cp can copy a set of files to a directory 

□ cp works on any file regardless of contents 

a cp used with the -r (recursive) option can copy entire directory hierarchies. 
See the cp(l) manual page for further details. 

rep is remote copy and is used to copy files and directories from other machines 
in the local network. 

See the r cp(l) manual page for further details, 
more is a one-way file browser. 

o more takes into account the size characteristics of your terminal and 
displays a page of a file at a time, 
o You scroll forward a page or a line at a time by typing keys. 

□ You can skip forward to selected patterns in the file. 

See the more(l) manual page for further details. 

emp performs binary comparison on a pair of files, emp reports the first place 
that it finds a difference in the data. Other facilities described in chapter 9 per- 
form more detailed comparisons on the differences between files. 

See the cmp(l) manual page for further details. 
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Displaying Beginning or End of head displays the first n lines of input. 

File 

tail displays the last n lines of input 

See die head(l) and tail(l) manual pages for further details. 

Splitting a File split carves a file into a number of pieces of a size specified by the user. You 

may need to do this at times, especially when dealing with some older utilities 
that have limitations on the number of lines they can digest at one time. 

See the split(l) manual page for further details. 

Converting Data Formats dd translates physical file formats for exchanging data with foreign systems. 

See the dd(l) manual page for further details. 

Checksum a File sum sums the words of a file, providing convenient checksum. 

See the sum(l) manual page for furtiier details. 



13. Summary of File and 
Directory Commands 

Table 7-1 



Here is an alphabetical list of the file and directory commands in this chapter. 



Summary of File and Directory Commands 



Program 

Name 



Function 



cat 


concatenate files 


cd 


change working directory 


chgrp 


change group 


chmod 


change access permissions 


emp 


binary compare files 


cp 


copy files 


dd 


convert file formats 


df 


display free space 


du 


display disk usage 


file 


find file type 


find 


find files 


head 


display head of file 


In 


make links to file 


Is 


display file and directory names 


mkdir 


create directory 


more 


page through file 


mv 


mote (rename) file 


pwd 


display name of working directory 


rep 


remote copy files 


rm 


remove file 


rmdir 


remove directory 


split 


split file 


sum 


checksum hie 


tail 


display tail of file 
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8.1. Local Communications 
Facilities 

Talking Directly with Another 
User 



Sending and Receiving Mail 



Communications Facilities 



The Sun system provides an electronic mail facility, access to the USENET net- 
work, and facilities for transferring files to and from remote machines. Com- 
munications facilities are in four broad categories: 

□ Communication between users on a single time-sharing machine. 

□ Communication between users on different machines in the local network. 

□ Communication between users on different host machines in geographically 
distributed locations. 

□ Facilities to access remote machines. 

The first two categories can be considered roughly equivalent since the local net- 
work facilities makes such acess transparent in many cases. 

You can communicate with other users on the same host or on other hosts in the 
local network in a variety of ways. 

write establishes direct workstation or terminal communication with another 
user on the same machine. 

talk establishes direct workstation or terminal communication with another 
user on a different machine in the local network. 

me sg inhibits receipt of messages from write and talk. 

See Mail and Messages — Beginner’s Guide and the write(l), talk(l), and 
mesg(l), manual pages for further details. 

mail is an electronic mail system that can send messages to users on the smae 
machine, on another machine in the local network, and to remote machines 
(using the capabilities of uucp described below). 

o Send a message to one or more users 

□ Read and dispose of each message individually 

o The presence of mail is announced by login and optionally by csh 

□ Save messages in files or forward them 

a Support for items such as ‘Subject:’ and ‘Cc:’ fields. 

See Mail and Messages — Beginner’s Guide and the mail(l) manual page for 
further details. 
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8^. Remote Communications 
Facilities 

Accessing Remote Machines 
Directly 



Transferring Data Between 
UNIX Systems 



When you want to access machines outside of the local network you must use 
one of the facilities described here. 

tip establishes full-duplex connection for logging in to remote UNIX systems 
via dialup lines 

□ provide transparent interface to remote machine 

□ transmit files 

□ take remote input from local file or put remote output into local file. 

See die t ip(l) manual page for further details. 

UUCP performs spooled file transfers between two UNIX madiines 

□ provide automatic queuing until line becomes available and remote machine 
is up 

a copy between two remote machines. 

In general, the facilities of uucp are not used directly by users but are there ate a 
service for programs such as the mail system to use. See System Administration 
for the Sun Workstation and the uucp(l) manual page for further details. 
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Text Editing and Text Processing 



Text processing has been one of the strong areas in the UNIX system. Given that 
you have a file full of text, there are many utilities to do useful work for you. 

The diagram shows a quick summary of some of the common text editing and 
processing utilities. 



Figure 9-1 Commonly Used Text Processing Utilities 





Uah Uah blah blah blah blah 
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Hah Hah blah blah Hah blah 
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Hah Hah blah blah Hah blah 
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Hah Hah blah blah Hah blah 
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Hah blah blah blah blah blah 
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9.1. Printing Text Files 
Preparing Files for Printing 



Printing Files Offline 



92 . fiiteractive and Non- 
interactive Text Editors 



Editing Text Files 
Visual Editor 



The following sections describe the functions and abilities of the text processing 
software in mote detail and provide pointers for further information. 

While Ipr is designated as the utility for sending files to the printer, Ipr by 
itself does no transformations on the text whatsoever and place no interpretations 
on the data in the text file — the UNIX system doesn’t have the notion of 
‘carriage-contror characters as in other systems, pr (described below) can be 
used to prepare a file for printing via Ipr. 

pr prepares files for printing by a printer program — usually Ipr. pr is a sim- 
ple but flexible utility, pr can: 

□ Place a tide, date, and page number on every page, 
o Arrange text into multiple columns. 

□ Merge several files into multiple columns in parallel. 

□ Specify the number of columns on a page and the number of lines on a page. 

See Using UNIX Text Utilities on the Sun Workstation and the pr(l) manual 
page for further details. 

Ipr is the line printer control program for spooling arbitrary files to printer for 
off-line printing. One option to Ipr can call up the pr program described above 
to paginate the text being printed. 

In addition to printing files, the line printer spooler system has facilities to exam- 
ine the print queue (Ipq) and to remove jobs firom the print queue (Iprm). 

See Using UNIX Text Utilities on the Sun Workstation and the Ipr(l), lpq(l), 
and Iprm(l) manual pages for further details. 

Text editors and other text manipulation software comprise a strong part of the 
facilities offered in the UNIX system. All text processing utilities lean heavily 
on the use of regular expressions to specify text patterns for searching. Major 
capabilities of searching via regular expressions include: 

□ match single characters or strings of characters 

□ match any arbitrary character 

□ match classes of characters , for instance, match any lower-case letter, or 
match upper-case letters in the range 1 thra M. 

□ match closures — zero to many of the previously mentioned patterns. 

□ match specified patterns only at the start or end of a line — such patterns are 
said to be anchored. 

□ match alternative patterns — this is known as alternation . Only some of the 
pattern scanning utilities, most notably egrep and awk, handle alternation. 

In addition to the textedit mouse-driven editor described in chapter 4, 

vi is the principal UNIX system tool for creating and editing text, vi is a 
screen-oriented display editor, providing ‘what you see is what you get editing’ 
for either line-oriented or full screen terminals. Capabilities include regular 
expression searching and user-specific settings. 
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Line Oriented Editor 



Original UNIX Line Oriented Editor 



Batch or Stream Editing 



9 J.. Information Processing 
and Text Manipulation 



Counting Things in Files 



See Using UNIX Text Utilities on the Sun Workstation and the vi(l) manual 
page for further details. 

ex is the line-oriented parent of vi, based on the original ed editor, ex sub- 
sumes all functions of ed. 

See Using UNIX Text Utilities on the Sun Workstation and the ex(l) manual 
page for further details. 

ed was the original line-editor for the UNIX system, ed has been superseded by 
more powerfiil display editors such as vi, but ed still has its place, most notably 
some utilities generate ed commands for automatic editing, ed is an interactive 
context editor providing random access to all lines of a file. Main features are; 

□ find lines by number or pattern — patterns may include specified characters, 
don’t care characters, choices among characters, repetitions of these con- 
structs, beginning of line, and end of line 

□ add, delete, change, copy, move or join lines 

□ permute or split contents of a line 

o replace one or all instances of a pattern within a line 

□ combine or split files 

□ escape to the Shell command language during editing 

□ do any of above operations on every pattern-selected line in a given range 

□ optional encryption for extra security. 

See Using UNIX Text Utilities on the Sun Workstation and the ed(l) manual 
page for further details. 

sed is a non-interactive stream text editor version of ed for processing large 
files 

□ sed can perform a sequence of editing operations on each line of an input 
stream of unbounded length 

□ Lines may be selected by address or range of addresses 

□ sed provides control flow and conditional testing, multiple output streams, 
and multi-line capability. 

See Using UNIX Text Utilities on the Sun Workstation and the sed(l) manual 
page for further details. 

Information Processing in UNIX includes utilities originally intended for statisti- 
cal text processing. Some categories include: 

□ Counting lines, words, and characters in a file 

□ Searching for specific patterns in a file 

□ Transliterating characters 

□ Sotting the contents of a file 

wc counts the lines, ‘words’ (blank-separated strings) and characters in a file. 

See Using UNIX Text Utilities on the Sun Workstation and the wc(l) manual 
page for further details. 
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Translating Characters tr transliterates characters in a file: 

□ Do one-to-one character translation according to an arbitrary code 

□ May coalesce selected repeated characters 

□ May delete selected characters. 

See Using UNIX Text Utilities on the Sun Workstation and the tr(l) manual 
page for further details. 

Scanning for Text Patterns gr ep is one of a family of programs that search for patterns in a file. 

Whence ‘GREP’? The name grep stands for ‘Global Regular Expression Print’ and is derived 

from the old ed line editor global command where you’d type 

^ 

q/RE/^ 

V / 



to print every line that contains the specified RE (regular expression). 

□ Display all lines in a file that satisfy a regular expression. 

□ Display all lines that fail to match 

□ Display count of matches 

□ Display first match in each file. 

Three flavors of pattern matching There ate actually three programs in the grep family: 
program 

grep is the original pattern scanning program, grep handles regular expres- 
sions containing any character, character classes , anchored matches , 
and closures . 

egrep is the extended version of grep. egrep handles all the regular 
expressions that grep can handle, plus alternation — look for an 
occurrence of pattern A or B or C, and so on. 

f grep searches for fixed strings. The only metacharacters supported are those 
that anchor the pattern to the begitming or end of a line. The fixed 
strings may be in a file. 

See Using UNIX Text Utilities on the Sun Workstation and the grep(l), 
egrep(l), and f grep(l), manual pages for further details. 

Sorting Files sort is the main general-purpose sort utility available on UNIX, sort sorts or 

merges ASCn files line-by-line. This program is radically different from the 
‘traditional’ sort-merge utilities found on other computer systems in that sort 
does not expect its input in fixed widdi fields starting in specific columns. 

Instead, sort breaks lines of a file into fields separated by whitespace (you can 
specify the field delimiter). The ‘punched card mentality’ doesn’t have a place 
here. Some of the features that sort offers are: 

□ No limit on input size 

□ Sort up or down 

□ Sort lexicographically or on numeric key 
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Removing Successive Duplicate 
Lines 



Sorting Topologically 



Scanning Patterns and 
Processing Text 



Whence ‘AWK’? 



Displaying Differences Between 
Files 



□ Multiple keys located by delimiters or by character position 

□ May sort upper case together with lower into dictionary order 

□ Optionally suppress duplicate data. 

uniq collapses successive duplicate lines in a file into one line. This facility is 
also obtained in tire sort utility, but it is useful to have the facili^ available as 
a separate function, uniq can report on lines that were originally unique, dupli- 
cated, or both, and can display a redundancy count for each line. 

tsort is a topological sort that converts a partial order into a total order. 

See Using UNIX Text Utilities on the Sun Workstation and the sort(l), 
uniq(l), and tsort(l) manual pages for further details. 

awk is a pattern scanning and processing language that makes it easy to specify 
many data transformation and selection operations, awk can be thought of as a 
‘programmable report generator’, awk contains all the capabilities of the grep 
family of pattern scanners, but awk can be programmed to manipulate the data 
from the text file and perform computations as well. 

The name awk does not have any magical significance but is tire initial letters of 
the authors — ‘Aho, Weinberger, and Kemighan’. Cutesy, cutesy, yes? 

□ awk searches its input file for specified patterns and performs actions on 
each line of input that satisfies the selection criteria. Patterns include regular 
expressions in the style of grep and egrep, arithmetic and lexicographic 
conditions, and Boolean combinations and ranges of these. 

□ Data is treated as string or numeric as appropriate. 

□ awk breaks its input into records and fields — fields are referenced as vari- 
ables. Records can span multiple lines. 

□ Expression and string manipulation works on variables and arrays (with 
non-numeric subscripts). 'Diere is a full set of arithmetic operators and con- 
trol flow in the style of the C programming language. 

n Output can be formatted as desired. Output can be directed to multiple out- 
put streams. 

See Using UNIX Text Utilities on the Sun Workstation and the awk(l) manual 
page for further details. 

dif f compares two files and report differences, dif f is so named because it is 
a differential file comparator — it does more than just report that there is a 
mismatch, diff can also: 

□ Report line changes, additions and deletions necessary to bring two files into 
agreement 

o May produce an editor script to convert one file into another — the editor 
script so generated is intended for the ed text editor described above. 
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A variant of dif f called dif f 3 compares two new versions of a file against 
one old one. 

See Using UNIX Text Utilities on the Sun Workstation and the dif f(l) and 
dif f 3(1) manual pages for further details. 

Finding Commonality Between comm identifies common lines in two sorted files. Output in up to 3 columns 

Files shows lines present in first file only, present in both, and/or present in second 

only. 

See Using UNIX Text Utilities on the Sun Workstation and the coitim(l) manual 
page for further details. 

Checking Spelling spell looks for spelling errors by comparing each word in a document against a 

25,000-word list that includes proper luunes 

□ Handles common prefixes and suffixes 

□ Collects words to help tailor local spelling lists. 

See Using UNIX Text Utilities on the Sun Workstation and the spell(l) manual 
page for further details. 



Searching for Words in a Sorted look searches for words in sorted file (usually a dictionary) that begin with a 
File specified prefix. 

See Using UNIX Text Utilities on the Sun Workstation and the look(l) manual 
page for further details. 

Encrypting and Decrypting crypt encrypts and decrypts files for greater security. 

Files 

See Using UNIX Text Utilities on the Sun Workstation and the crypt(l) manual 
page for further details. 



Joining Records in File join combines two files by joining records that have identical keys. 

See Using UNIX Text Utilities on the Sun Workstation and the join(l) manual 
page for further details. 

9.4. Summary of Text Here is an alphabetical list of the text utilities described in this chapter. 

Processing Utilities 

Table 9-1 Summary of Editing and Text Processing Programs 



Program 

Name 


Function 


awk 


Scan patterns and process text 


conun 


Find commonality between files 


crypt 


Encrypt 


decrypt 


Decrypt files 


diff 


Display differences between files 


ed 


(very primitive) line editor for text files 


egrep 


Scan for text patterns 


ex 


Line oriented editor for text files 
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fgrep 


Scan for text patterns 


grep 


Scan for text patterns 


join 


Join records in file 


look 


Search for words in a sorted file 


Ipq 


Display print queue 


Ipr 


Print files offline 


Iprm 


Remove jobs from print queue 


Pr 


Prepare files for printing 


sed 


Batch or stream editing 


sort 


Sort files 


spell 


Check spelling 


tr 


Translate characters 


uniq 


Remove adjacent duplicate lines from sorted file 


vi 


Visual editor for text files 


wc 


Count characters, words, and lines in files 
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Programming Languages 



Sun Microsystems supports compilers for C, FORTRAN 77, and Pascal. Sun 
Microsystems have made major improvements to the quality and performance of 
all three languages. Programming at the assembler language level is also sup- 
ported. The link editor combines object code modules into final executable pro- 
grams as shown in the diagram below. 

Figure 10-1 Flow from Source Code to Compiled Program 
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10.1. C Programming 
Language 



Compiling C Programs 



Symbolic Definitions and 
Conditional Conpilation 



Checking Validity ofC 
Programs 



Chapter 1 1 contains information about the various tools available to assist the 
software development process. 

The Sun operating system and most of the utilities are written in C. For a 
description of C, read The C Programming Language , Brian W. Kemighan and 
Dermis M. Ritchie, Prentice-Hall, 1978. 

C is a general purpose language designed for structured programming: 

□ Generalized initialization, block stmcture, long integers, unions, and explicit 
type conversions 

□ Enhanced to take arbitrary length variable names. 

n Supports definable data types, which include character, integer, float, double, 
enumeration types, pointers to all types, functions returning above types, 
arrays of all types, structures and unions of all types 

□ Operations intended to give machine-independent control of full machine 
facility, including to-memory operations and pointer arithmetic 

□ Macro preprocessor for parameterized code and inclusion of standard files 
o All procedures recursive, with parameters by value 

□ Machine-independent pointer manipulation 

□ Object code uses full addressing capabili^ of the Sun Workstation 

□ Runtime library gives access to all system facilities. 

cc is the C compiler which can compile and/or link edit programs in the C 
language. The C compiler has been enhanced to take arbitrary length variable 
names, allowing readable names and supporting interfaces with other languages 
such as FORTRAN 77 and Pascal. 

See the cc(l) manual page for further details. 

cpp is a the C preprocessor, cpp has facilities for 

□ defining symbolic names. 

□ defining macros 

□ conditional compilation 

o can also be used witfi FORTRAN. 

See the cpp(l) manual page for further details. 

lint is a verifier for C programs. By itself the C compiler tends to be some- 
what forgiving of programming styles which would give rise to compiler error 
messages in (say) Pascal, lint reports questionable or nonportable usage such 
as mismatched data declarations and procedure interfaces, nonportable type 
conversions, unused variables, unreachable code, no-effect operations, mistyped 
pointers, and obsolete syntax, lint can do full cross-module checking of 
separately compiled programs, and can check the for correct use of library func- 
tions. 

See Programming Utilities for the Sun Workstation and the lint(l) manual 
page for further details. 
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Formatting C Programs 



10.2. FORTRAN 

Compiling FORTRAN 
Programs 



FORTRAN Preprocessor 



103. Pascal Programming 
Language 



indent is a formatter for arranging C source code into standard styles: 

□ Several dilfemt styles are available for placement of comments, arrangement 
of declarations, compound-statement braces, and case labels. 

□ Can format a program suitable for processing by trof f . 

□ You can set up a profile of your own options for indent. 

FORTRAN 77 is the latest standard from the ANSI FORTRAN standards committee. 

£77 is a full compiler for ANSI Standard FORTRAN 77. Major features are: 

□ compatible with C and supporting tools at object level 

□ optional source compatibility with FORTRAN 66 

□ free format source 

o optional subscript-range checking, detection of uninitialized variables 
a all widths of arithmetic: 2-byte and 4-byte integer 
o 4-byte and 8-byte real; 8-byte and 16-byte complex. 

See FORTRAN Programmer’ s Guide for the Sun Workstation and the £77(1) 
manual page for further details. 

rat £or stands for ‘Rational FORTRAN’ and was developed before the advent of 
FORTRAN 77 to add rational control structure like C’s to FORTRAN. Highlights of 
the rat£or language are: 

□ compound statements — statements can be grouped into blocks. 

□ stmctured programming constructs — if-else, do, for, while, repeat-until, 
break, next. 

□ symbolic constants via a macro facility. 

□ file inclusion. 

□ free format source independent of FORTRAN’S colunm-oriented restrictions. 

□ translates relational operators like > and >= into the more obscure FORTRAN 
forms of . GT . and . GE . 

rat£or produces genuine FORTRAN to carry away and may be used with FOR- 
TRAN 77. 

See FORTRAN Programmer s Guide for the Sun Workstation and the rat- 
£or(l) manual page for further details. 

The Pascal system for the Sun Workstation is derived from the Pascal compiler 
and interpreter implemented by William N. Joy and Charles Haley at the Univer- 
sity of California at Berkeley. The Pascal system is an ANSI Pascal compiler and 
interpreter system. 

Other tools in the Pascal system include: 
px a Pascal execution profiler 
pxre£ 

a program for making cross-referenced listings of Pascal programs. 

See Pascal Programmer’ s Guide for the Sun Workstation and the pc(l), px(l), 
and pxre£(l), manual pages for further details. 



wsun 

XT microsystems 



A of 15 February 1986 




74 System Overview 



10.4. Assembler as is the machine-level assembler for the Sun hardware family. 

□ as creates object program consisting normally of read-only and sharable 
code, initialized data or read-write code, uninitialized data. 

□ Relocatable object code is directly executable without further transforma- 
tion. 

□ Object code normally includes a symbol table 

□ ‘conditional jump’ instmctions become branches or branches plus jumps 
depending on distance. 

See Assembly Language R^erence Manual for the Sun Workstation and the 

as(l) manual page for further details. 



10.5. Linker 



Id is the link editor 

□ Combine relocatable object files. 

□ Insert required routines from specified libraries 

□ Resulting code is sharable by default. 

See the ld(l) manual page for further details. 
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Software Development Tools 



From its inception, the UNIX system has been extremely strong in supporting 
software development. The system grew within a group of computer scientists 
pursuing research in computer science. Sun Microsystems continues to add to 
the quality of the programming and programming language support tools. 



11 . 1 . 



Programming Tools to 
Work With Object Code 



The diagram below shows the flow from source code to object code, plus the 
major groups of tools that can be used with the object code. A later diagram 
shows more detail. 
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Now on a more detailed level, here are the more commonly used tools to work 
with object code. 

Figure 11-2 Commonly Used Tools to Work with Object Code 




Debugging Programs at the 
High Level 



Main features and most commonly used commands of dbx are: 

□ Multiple source language debugging. 

□ Can display a stack backtrace to show where a program stopped. 

□ Can stop at specific lines in the source file, stop in specific functions, or can 
stop when specific events (such as a variable becoming equal to a designated 
value) occur. 

□ Display the value of variables by name. Displaying can be indirect through 
pointers. 



dbxtool and dbx are part and parcel of the same debugging capability, 
dbxtool is a window-based source level debugger, dbxtool is based on 
dbx, a source level debugger for programs written in C, FORTRAN 77, or Pascal, 
or any combination of them. 
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□ Execute designated commands when specific conditions become tme. 

□ Tracing facility available. 

□ Can debug arbitrary processes. 

□ Can debug multiple processes. 

□ Can be used to debug the kernel. 

dbxtool is a window and mouse-based interface to dbx. All the features of 
dbx are available in dbxtool except that you can perform the most common 
operations (print, next, step, stop at, stop in, cont, and redo) by ‘pushing a button’ 
in the control panel. 

The dbxtool window has five areas; 

□ status window displays the file and line number range of the code in the 
source window and information about the current state of the debugging pro- 
cess. 

□ source window usually displays the current focus of execution, though you 
can move it to any part of a source file (or to any other file). 

□ menu of command buttons contains the commands that can be constructed 
with the mouse. 

□ command dialogue window provides an area where you can type commands 
and where the commands obtained from the buttons window are echoed. 

□ variable values display window (generally called the “display window”) 
displays the values of selected variables and expressions whenever execution 
halts. 

In addition to the standard ‘buttons’ in the control panel, you can constmct your 
own buttons, eidier as you go, or in a dbxtool profile. The picture shows a 
dbxtool window with a program being operated on. 
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Figure 11-3 Example dbxtool Mmfovv 



1 3.0: /bin/csh 
Dbxtool 



Awaiting Execution 
File Displayed: ./print. index. c 






Lines: 18-39 



struct index_entry 



•node; 



if (node == NULL) 
return; 

pr i nt_ i ndex ( node-> 1 esser ) ; 
print_node(node, previous_ index. 
5 pr3vious_index_entry = node; 
pr i n t. i ndex ( node->gr eat er ) ; 



/• 

• Print out an Index entry 

*/ 

print.node(node, previous) 
struct index_entry *node; 

struct index_entry *previous; 

{ 



mtry); 



int 



level ; 



Reading symbolic information... 

Read 787 symbols 
(dbxtool) func print.index 
(dbxtool) stop in print.node 

(1) stop in print.node 
(dbxtool) print index. entry 
can^'t evaluate a typeid 
(dbxtool) print node 
"node" is not active 

(dbxtool) stop at "print. index. c" :26 

(2) stop at "print. index. c" : 26 
(dbxtool ) 



See Debugging Tools for the Sun Workstation the dbxtool(l) and dbx(l) 
manual pages for further details. 

Debugging at the Machine adb is a very low-level symbolic debugger. It is now largely superseded by 

Level dbxtool and dbx. Some of adb’s features include: 

□ Examine arbitrary files with no limit on size 

□ Interactive breakpoint debugging with the debugger as a separate process 

□ Symbolic reference to local and global variables 

□ Patching 

□ Stack trace for C programs 
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Building and Maintaining 
Libraries 



Dumping File Contents 



Displaying the Namelist 



Displaying Size of a Program 



Stripping Relocation and 
Symbol Table 



Serach for ASCII Strings in 
Binary File 



o Output formats of: 1-, 2-, or 4-byte integers in octal, decimal, or hexade- 
cimal, single and double floating point, character and string 

□ Disassembled machine instructions. 

See Debugging Tools for the Sun Workstation and the adb(l) manual page for 
fluther details. 

ar is the library maintenance utility, ar’s principal use is to build and maintain 
object code libraries for use by Id — the link editor, ar can be used as a gen- 
eral utility for collecting groups of files into a single unit, ar’s major features 
include: 

□ maintain archives and libraries 

o combine several files into one for housekeeping efficiency 

□ create new archive 

o update archive by date 

□ replace or delete files from the archive 

□ display table of contents (what files are in the archive) 

□ retrieve files from archive. 

See the ar(l) manual page for further details. 

od dumps the contents of any file. Output options include 

□ any combination of octal or decimal by words, octal by bytes, ASCII, 
opcodes, hexadecimal 

D Range of dumping is controllable. 

See the od(l) manual page for further details. 

run displays the namelist (symbol table) of an object program. Provide control 
over the style and order of names that are printed. 

See die nm(l) manual page for further details. 

size displays the memory requirements of one or more object files. 

See the size(l) manual page for further details. 

strip removes the relocation and symbol table information from an object file 
to save space. 

See die strip(l) manual page for further details. 

strings is a useful tool to locate ASCII strings in a binary file. 

See the strings(l) manual page for further details. 
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11.2. Performance Analysis 
Tools 



Timing a Program 



Profiling a Program 



Generating a Call Graph 
Profile 



Analysing Code Coverage 



lU. Program Generation 
Tools 



Sun Microsystems supplies several facilities for monitoring performance of 
software, ranging from a simple command to report the time a program takes to 
execute, to a code-coverage tool to provide detailed statement-by-statement 
analysis of a program. 

time is a simple system command that just produces a report on how much time 
a given program takes to execute. 

See Programming Utilities for the Sun Workstation and the t ime(l) and 
/bin/time(l) manual pages for further details. 

prof constracts a profile of time spent per routine from statistics gathered by 
time-sampling the execution of a program, prof also displays subroutine call 
frequency and average times for C programs. 

See Programming Utilities for the Sun Workstation and the prof (1) manual 
page for further details. 

gprof is a step up from prof, gprof constmcts a call-graph profile for a 
program. The call-graph profile not only includes the ‘flat’ profile in the same 
style as prof , but it also displays the callers of a specific routine, the callees of a 
specific routine, and the number of times a routine was called or called another 
routine. 

See Programming Utilities for the Sun Workstation and the gprof (1) manual 
page for further details. 

tcov is a code coverage tool that satisfies two widely divergent needs: 

□ It increases the resolution of prof and gprof down to the statement level, 
thereby providing extremely detailed analysis of where a program spends its 
time. 

□ It provides a report on which parts of a program are actually being executed. 
Such a report can be used (for instance) to discover how much testing a 
given set of regression tests are actually doing. 

See Programming Utilities for the Sun Workstation and die tcov(l) manual 
page for further details. 

Frederick Brooks pointed out^ that there is a world of difference between a pro- 
gram (something that a couple of guys can cobble together in their garage over a 
weekend) and a programming systems produuct (a whole system that must work 
together and be documented). The UNIX system supplies many tools for assist- 
ing in the job of generating large systems. Two of the tools that assist program- 
ming in the large are make (building and maintaining consistency), and sees 
(maintaining history). 



The Mythical Man Month 
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Building and Maintaining 
Programs 



Maintaining History 



11.4. Compiler Development 
Tools 



make is an indispensable tool for making sure that large programs are properly 
compiled with minimal effort make has several unique features: 

□ You specify via a control file (called a makefile ) what you want to build — 
called a target, what things the target depend on — called dependencies, 
and how to go about constructing the target from its dependents — rules . 

□ make has iimate rules that specify the dependencies between object files and 
the C compiler, FORTRAN compiler, yacc, lex and so on. 

See Programming Utilities for the Sun Workstation and the make(l) manual 
page for further details. 

sees is the Source Code Control System, sees maintains and controls multi- 
ple versions of text files, sees maintains the multiple versions in an SCCS data- 
base. 

□ You initially create an SCCS database for a file to establish the initial ver- 
sion. 

o You get a read-only copy of a file from the database for compiling or any 
other activity that doesn’t involve changing the file. 

□ You edit a writeable copy of a file from the database for making changes. 

□ You delta the modified copy of die file back into the database when you 
are satisfied with the changes you made. The delta is a record of the differ- 
ences between this version and the last version. The current version of the 
database file is thus a complete list of all changes made during the file’s his- 
tory. 

See Programming Utilities for the Sun Workstation and the sccs(l) manual 
page for further details. 

lex and yacc started life as utilities to assist generating lexical analyzers and 
syntactic parsers for compiler development. Over time, they have been applied 
to other areas such as a language for describing equations in document produc- 
tion (eqn), for the syntax analyzer for the make program, and for a language to 
described pictures for document production (pic), lex and yacc are con- 
stmeted to work together, as shown in Figure 1 1-4 below. 
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Figure 11-4 lex arui ya.cc In Program Development 




Generating Lexical Analyzers lex generates lexical analyzers. Highlights are: 

□ Converts specification of regular expressions and semantic actions into a 
recognizing subroutine 

o Arbitrary C fimctions may be called upon isolation of each lexical token 

□ Full regular expression, plus left and right context dependence 

□ Resulting lexical analyzers interface cleanly with yacc parsers. 

See Programming Utilities for the Sun Workstation and the lex(l) manual page 
for further details. 

Generating Syntactic Parsers yacc is an LR(l)-based compiler writing system 

□ During execution of resulting parsers, arbitrary C functions may be called to 
do code generation or semantic actions 

o BNF syntax specifications 

□ Precedence relations 

□ Accepts formally ambiguous grammars with non-BNF resolution rules. 

See Programming Utilities for the Sun Workstation and the yacc(l) and 
eyacc(l) manual pages for further details. 




A of 15 February 1986 





86 System Overview 



11^. Other Programming In addition to the tools described above, there are some ancillary utilities that 

Tools find diverse applications. 

Macro Processing m4 is a general purpose stream-oriented macroprocessor that recognizes macros 

anywhere in text 

□ Syntax fits with functional syntax of most higher-level languages 

□ m4 can evaluate integer arithmetic expressions. 

See Programming Utilities for the Sun Workstation and file m4(l) manual page 
for further details. 



Calculators — dc dc is an interactive programmable desk calculator 

n Has named storage locations as well as conventional stack for holding 
integers or programs 

□ Unlimited precision decimal arithmetic 

□ Appropriate treatment of decimal fractions 

□ Arbitrary input and output radices, in particular binary, octal, decimal and 
hexadecimal 

o Reverse Polish operators: 

+ -*/ 

remainder, power, square root, load, store, duplicate, clear, 
print, enter program text, execute. 

See Games, Demos, and Other Pursuits — Beginner’s Guide and the dc(l) 
manual page for further details. 



Calculators — be be is a C-like interactive interface to the dc desk calculator described above 

□ be has all the capabilities of dc with a high-level syntax 

□ Arrays and recursive functions 

□ Immediate evaluation of expressions and evaluation of functions upon call 

□ Arbitrary precision elementary functions exp, sin, cos, atan 

□ Go-to-less programming. 

See Games, Demos, and Other Pursuits — Beginner’s Guide and the bc(l) 
manual page for further details. 



11.6. Summary of Language 
Utilities 



Figure 11-5 




Here is an alphabetical list of the utilities described in this chapter. 



Summary of Language Processing Programs 
Program Function 



adb 


Debug at the machine Level 


ar 


Build and maintain libraries 


dbx 


Debug programs at the high Level 


dbxtool 


Debug programs at the high Level 


gprof 


Generate a call graph profile 


Id 


Link programs 
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lex 


Generate lexical analyzers 


lint 


Check validity of C programs 


m4 


Macro processor 


make 


Build and maintain programs 


nm 


Display the namelist 


od 


Dump file contents 


prof 


Profile a program 


sees 


Control revision history 


size 


Display size of a program 


strip 


Strip relocation and symbol table 


teov 


Analyse code coverage 


time 


Time a program 


yaee 


Generate syntactic analyzers 
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Graphics Tools 



Sun Microsystems support for graphics leans heavily on standards. Figure 12-1 
below illustrates the relationships between the various graphics packages. 

Hgure 12-1 Graphics Standards 




Note that not all of the graphics packages shown in die diagram are actually sup- 
plied as Sun products — to date, Sun Microsystems supply these graphics pack- 
ages: 




91 



AoflSFebnuiyl986 















92 System Overview 



SunCore is m implemeatation of the ACM SIGGRAPH Core System . SunCoreisa 

compiehemive package of engineering graphics software {noviding support for 
interactive 3D graphics application programs. SunCore conforms to level 3C 
(dynamic output with 3D scaling, rotation and translation) of the Core 
specification for output primitives, and to level 2 (complete input) for input prim- 
itives. 

See SunCore Reference Manual for the Sun Workstation for ftiitiier details. 

SunGKS is an implementation of the ANSI Graphical Kernel Standard (GKS). The Graph- 

ical Kernel System (GKS) is a graphics standard designed for 2D interactive com- 
puter graphics on workstations. SunGKS conforms to level 2C (Workstation 
Independent Segment Storage and full input) of the GKS standard. 



See Su/^KS Reference Manual for the Sun Workstation for further details. 

SunCGI is an implementation of the ANSI Computer Graphics Interface (CGI). Previ- 

ously, CGI was known as the Virtual Device Interface (VDI) standard. SunCGI 
provides access to low-level graphics device functions witiiout the restrictions, 
benefits, or overhead of higher-level graphics packages like SunCore. SunCGI 
is useful for 2D graphics programs which do not require segmentation or 
transformations. The absence of segmentation from SunCGI makes drawing 
diagrams faster and simpler, but does not provide automatic picture regeneratioiL 
SunCGI programs are usually smaller and more efficient th^ SunCore pro- 
grams wiA similar functionally. 

See SunCGI R^erence Manual for die Sun Workstation for further details. 

Pixrect is an implementation of the is a low-level RasterOp graphics library for writing 

device-independent applications for Sun products. The Pixrect library is the 
lowest level interface to the display device, sitting just above the device drivers. 
Pixrect does not provide support for input devices or overlapping windows. 

See Pixrects R^erence Manual for die Sun Workstation for further details. 
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Sun Operating System — Internal 

Features 



Sun Microsystems provides its own enhanced version of the UNIX operating sys- 
tem as the basic operating software to exploit the resources of Sun hardware pro- 
ducts. This chapter descibes the major features of the operating system. 

At the bottom layer of the operating system is the kernel — a collection of sys- 
tem services that manage the resources of the system on behalf of application 
programs. Applications can either access the kernel’s primitive functions 
directly, or more usually, applications make use of library functions that in turn 
use the kernel’s primitive functions. 



Figure 13-1 Kernel Primitive Functions 
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getdoma inname 




mmap 




sigvec 




prof il 




select 




getrlimit 


gethostname 




sbrk 




sigstack 




gettimeofday 




dup 




getrusage 


ioct 1 




getpagesize 




kill 




time 




get dt able size 




getpriority 










. . . 




. . . 




. . . 







The kernel primitive functions can be associated into the functional groups 
shown in figure 13-1 above. The UNIX Interface Overview and section 2 of the 
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UNIX Interface Reference Manual contain details on the kernel functions. 

As mentioned above, most applications will use one or more standard library 
packages that in turn call the kernel. The main groups of library packages are 
illustrated in figure 13-2 below. 



Figure 13-2 Standard Library Packages 
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There is in fact a minor piece of misdirection in the picture above — the Stan- 
dard I/O library is in fact a part of the C library, but is shown separate here for 
illustrative reasons. To find out more about the various libraries you should con- 
sult these manuals; 



Library 
C Library 

Standard I/O Library 
Network Library 



Described in Manual(s) 

UNIX Interface Reference Manual (section 3) 

Programming Tools for the Sun Workstation 
UNIX Interface Reference Manual (section 3S) 

Networking on the Sun Workstation 

UNIX Interface Reference Manual (section 3N) 
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Device-independent HO and 
redirection 

Virtual memory 
Job Control Facilities 



13.1. Networking Facilities 



RPC Library 

Math Library 
FORTRAN Libraries 

Pascal Library 
lex Library 
CGI Libraries 
SunCore Libraries 
Suntools Library 
Sunwindows Library 
Pixrect Library 
Database Library 
Curses Library 
Terminal Driver Libraries 
Plot Library 



Networking on the Sun Workstation 

UNIX Interface Reference Manual (section 3R) 

UNIX Interface Reference Manual (section 3M) 

FORTRAN Programmer’s Guide for the Sun Works- 
tation 

Pascal Programmer’s Guide for the Sun Workstation 
Programming Tools for the Sun Workstation 
CGI Reference Manual for the Sun Workstation 
SunCore Reference Manual for the Sun Workstation 
SunView System Programmer’s Guide 
SunView System Programmer’s Guide 
Pixrect Reference Manual for the Sun Workstation 
UNIX Interface Reference Manual (section 3X) 
UNIX Interface Reference Manual (section 3X) 
UNIX Interface Reference Manual (section 3X) 
UNIX Interface Reference Manual (section 3X) 



Other major features of the operating system are described below. 



Highly efficient buffered stream I/O is integrated with formatted input and out- 
put. 



Supports processes up to 256 megabytes (given adequate disk space for paging) 
for greatly enhanced amount of available main memory and reduced delays when 
running programs as only the parts of the program needed to be loaded in core 
are in fact loaded. 



The 4.2BSD operating system and Sun Microsystems operating software pro- 
vides facilities for job control that were missing in previous implementations of 
the UNIX operating system. Job control provides support for multiplexing termi- 
nals between jobs, mnning several jobs at once, some in the background and oth- 
ers in the foregroimd and moving mnning jobs from background to foreground 
and vice-versa. These facilities are provided to the user via the C-Shell com- 
mand interpeter described in chapter 5. 

The Sun operating system includes an ISO-OSI model local networking subsys- 
tem. Fully supported is the DARPA internet family of protocols and associated 
addressing. The datagram (UDP) and stream (TCP) protocols are supported, as 
well as the error message protocol (ICMP) and packet forwarding at the internet 
layer (IP). A routing information protocol allows hosts to determine the shortest 
route to a destination within the local network. 

The OSI model is a layered mode, as shown in the diagram. 
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Figure 13-3 Network Architecture 
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Remote Procedure Call The Remote Procedure Call (RPC) facility provides a mechanism whereby one 

process (the caller process) can have another process (the server process) exe- 
cute a procedure call, as if the caller process had executed the procedure call in 
its own address space (as in the local model of a procedure call). Because the 
caller and the server are now two separate processes, they no longer have to live 
on the same physical machine. 

The RPC mechanism is implemented as a library of procedures, plus a 
specification for portable data transmission, known as the eXtemal Data 
Representation (XDR). Both RPC and XDR are portable, providing a kind of stan- 
dard I/O library for interprocess communication. Thus programmers now have a 
standardized access to sockets without having to be concerned about the low- 
level details of the accept ( ) , bind ( ) , and select ( ) procedures. 

Interprocess Communication The network (interprocess) communications facilities dervied from 4.2BSD are 

based on the socket . 

Network communication using standard protocols. 

□ Inter-process comnrunications integrated into UNIX. 

□ User access to interprocess and network communication through sockets. 

□ Arbitrary processes in the system may communicate in either a message or 
stream oriented fashion. 

o Communications via the socket mechanisms provide remote logins, copies, 
and Shells over the local network. 

Remoted Procedure Call (RPC) services provide an easier to use layer of abstrac- 
tion than does the socket mechanisms. However, you can find the appropriate 
information in Networking on the Sun Workstation in the sections on Interpro- 
cess Communication. Sections 2 and 3 of the UNIX Interface R^erence Manual 
contain details of the function calls. 
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Reference Documentation 



Programmers wishing to use the networking facilities can refer to one or more of 

these documents that are a part of the general manual called Networking on the 

Sun Workstation : 

Network Services Guide 

is for users who have a general interest in networlc services. It explains the 
network file system and the yellow pages facilities in some detail. Although 
it is not a manual for system administrators, the material is heavily slanted in 
that direction. 

Remote Procedure Call Programming Guide 

is for programmers who wish to write network applications using remote 
procedure calls, thus avoiding low-level system primitives based on sockets. 
Readers must be familiar with the C programming language, and should 
have a working knowledge of network theory. 

External Data Representation Protocol Specification 

is for programmers writing complicated applications using remote procedure 
calls, who need to pass complicated data across the network. It is also a 
reference guide for system programmers implementing Sun’s Network File 
System on new machines. 

Remote Procedure Call Protocol Specification 

is a reference guide for system programmers implementing Sun’s Network 
File System on new machines. It is of litde interest to programmers writing 
network applications. 

Network File System Protocol Specification 

is a reference guide for system programmers implementing Sun’s Network 
File System on new machines. It is of little interest to programmers writing 
network applications. 

Yellow Pages Protocol Specification 

is a reference guide for system programmers implementing a Yellow Pages 
database facility on new machines. It is of little interest to programmers 
writing network applications. 

Inter-Process Communications Primer 

taken from Berkeley’s 4.2 release, is for system programmers who need to 
use low-level networking primitives based on sockets. Since remote pro- 
cedure calls are easier to use than sockets, this primer is of littie interest to 
most network programmers. 

Network Implementation 

describes the low-level networking primitives in the 4.2 UNIX kernel. It is 
of interest primarily to system programmers and aspiring UNIX gums. 
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SunGuide — Window Programming 

Interface 

SunView is the external user’s view of the user interface, SunView is built on top 
of SunGuide — Sun General User Interface Design Environment — is a general 
toolkit for building window-based applications 

The window system programming interface is a collection of subroutine 
libraries. There are three major levels of abstraction in the programming inter- 
face to the window system, and a programmer can use any or all of these three 
layers to write applications. 

The user interface (external features) of the window system is described in 
chapter 4 — SunView — User Environment. 

The three major layers of SunView are: 

□ SunGuide 

□ SunWindows 

□ Pixrects 

Pixrects are at the lowest layer of the system, close to the hardware drivers. 
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SunGuide Facilities 



Figure 14-1 



Here is a general diagram of the layering. 
Layering ofSunView 
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Mouse-oriented Text Facility 




Selection Service 
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Basic Window Device 




Window Display Package 




Pixrects 


Device Independent 
Pixel Rectangle Access 





Drivers 



SunGuide contains the abstractions — the toolkit — to build applications 
software: 

User Interface Utilities include 

□ the notifier — the agent that distributes events among multiple applications. 

□ the selection service — the agent that manages text selections. 

Building Blocks include 

□ text subwindows for displaying textual data. 

□ canvas subwindows for displaying graphical information. 

□ scrollbars for scrolling backwards and forwards in a file. 

□ Control Panels containing ‘pushbuttons’ for selecting actions. 
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SunWindcws Facilities 



Pixrects 



Further Reading 



0 Menus to bring up choices for the user to select among. 

There is a general-purpose mouse-oriented text facility containing functions to 
select, extend, cut, and paste. 

SunWindows facilities include the basic window manager and window display 
package. 

Pixrects are a set of low-level device-independent routines that manage pixel rec- 
tangles . The Pixrect layer interfaces to the hardware device drivers. 

For further details on programming for the Sun Window System you should read: 

□ SunView Application Programmer’s Guide . 

□ SunView System Programmer’ s Guide . 

o Pixrects Reference Manual for the Sun Workstation for details of the low- 

level routines that interface directly to the frame buffer. 
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Document Production 



Bell Laboratories is one of the world’s largest research institutions and as such, 
generates vast amounts of technical papers. Early in its life, the UNIX system 
was enhanced with software to assist the job of producing technical documents. 
The major tool that evolved for the job was called t r of f — a text formatter 
oriented towards driving a second-generation phototypesetter called a C/A/T. 

Today, t rof f is the main utility for formatting documents. Although trof f is 
capable of very complex feats of typographic formatting, the nature of the dev- 
ices for which trof f was originally intended resulted in a program that must be 
instructed in excmciating detail as to how a document should be laid out. Not 
only must users be familiar with the details of each tr of f request, but they 
must also be knowledgeable of typography terms and concepts. Over the years 
of its life, trof f has been surrounded by sundry utilities and tools to ease users’ 
jobs. Macro packages are perhaps the most important tool to help users in gen- 
erating documents. A macro package may be thought of as a style guide — 
users type in ‘high-level’ commands reminiscent of the structure of the document 
instead of hundreds of detailed trof f requests. 

In addition to macro packages, various preprocessors take over special effects 
such as mathematical equations, tables, and line drawings. The picture below 
conveys some of the flavor of die extensive battery of tools available for produc- 
ing documents on the UNIX system. 
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Figure 15-1 Document Formatting Model with Macro Package 
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15.1. Formatting Documents trof f and nrof f are the major document formatting programs available on 

the UNIX system. Although there are now ‘What You See Is What You Get’ 
(WYSIWYG) document preparation packages available for the Sun Workstation, 
trof f and nrof f still have their place in a variety of very difficult formatting 
applications where WYSIWYG systems don’t as yet fit the bill. 

trof f was originally written (very specifically) for a specific second-generation 
phototypesetter, t rof f can be used with appropriate conversion utilities to 
drive other types of devices, nrof f drives ASCII terminals of all types, 
trof f and nrof f accept the same input language and are capable of elaborate 
formatting feats when appropriately programmed 

□ completely definable page format keyed to dynamically planted ‘interrupts’ 
at specified lines 

□ maintains several separately definable typesetting environments (for exam- 
ple, one for body text, one for footnotes, and one for unusually elaborate 
headings) 

o arbitrary number of output pools can be combined at will 

□ macros with substitutable arguments, and macros invocable in mid-line 

□ computation and printing of numerical quantities 

□ conditional execution of macros 

□ tabular layout facility 

□ positions expressible in inches, centimeters, ems, points, machine units or 
arithmetic combinations thereof 

□ access to character-width computation for unusually difficult layout prob- 
lems 

□ overstrikes, built-up brackets, horizontal and vertical line drawing 

□ dynamic relative or absolute positioning and size selection, globally or at the 
character level 

o can exploit the characteristics of the terminal being used, for approximating 

special characters, reverse motions, proportional spacing, etc 

□ typesetter has a vocabulary of several 102-character fonts (4 simultaneously) 
in 15 sizes. 

□ trof f provides terminal output for rough sampling of final output 

□ nrof f produces multicolumn output on the workstation (or terminal capa- 
ble of reverse line feed), or through the col postprocessor. 

See Formatting Documents on the Sun Workstation and Using nrqffand trojfon 
the Sun Workstation and the trof f (1) and nrof f (1) manual pages for further 
details. 

15.2. Macro Packages Using raw trof f codes by themselves to describe a document has been likened 

to writing microcode for a typesetter. Such a process is extremely time- 
consuming and difficult to make any substantive changes in style or layout after- 
wards. For this reason, trof f incorporates a macro facility where frequently- 
used sequences of trof f requests are collected together into named chunks, and 
then you call the chunks by name to achieve standardized formatting actions. 

A macro package can be considered the style sheet for a document. The user 
types in ‘high-level’ instructions to indicate the start of text constmcts such as 
paragraphs, tables, and such, and the macro packages translates these instmctions 

Asun A of 15 February 1986 

^ microsystems 





112 System Overview 



into the detailed troff requests needed to achieve the desired layout 

-ms Macro Package Sun supports the -ms macro package — a standardized manuscript layout pack- 

age of canned requests for use with nroff and troff. Some of the features 
that -ms provides include: 

□ Standard indented paragraphs, block-paragrajdis, itemized paragraphs, 
quoted paragraphs. 

o Various forms of indented and non-indented displays, ‘keep’ displays, float- 
ing displays, tables, and displayed and numbered equations. 

□ Automatically numbered headings. 

□ Footnotes — automatically numbered or with user-defined callouts. 

□ Multiple-column layout 

□ Standardized placing of page numbers. 

□ Standardized running headers and footers — users can specify in detail the 
form of odd and even headers and footers. 

□ Draft dates. 

See Formatting Documents on the Sun Workstation for further details. 

-man Macro Package The -man macro package is die second major macro package designed for for- 

matting the on-line manual pages. The -man macro package is less complex 
than the -ms macro package. 

See Formatting Documents on the Sun Workstation for further details. 

-me Macro Package The -me macro package — another package of canned formatting requests — is 

also available. The -me macro package was developed at the University of Cal- 
ifornia at Berkeley specifically for the computer science environment there. 

See Formatting Documents on the Sun Workstation for further details. 

15.3. troff Preprocessors trof f ’s major preprocessors are tbl for describing tabular layouts, and eqn 

for describing mathematical equations. Both tabular layout and mathematics are 
known as ‘penalty copy’ in the typesetting trade because of the large number of 
fine detailed formatting requests needed. 

Mathematical Typography eqn is a mathematical typesetting preprocessor for troff. eqn translates 

easily readable formulas, either in-line or displayed, into detailed troff or 
nroff instmetions. 

Example of eqn Formulas are written in a style as if you were ‘talking’ them over the telephone 

to someone else: 




to produce: 
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Laying Out Tables 



Example of a Table 



neqn is a version of eqn for nrof f . neqn accepts the same input language 
as eqn and prepares formulas for workstation or terminal display, neqn has the 
same facilities as eqn within the graphical capability of the workstation. 

Main features of the eqn language are: 

□ Automatic calculation of size changes for subscripts, sub-subscripts, and 
such for equation such as e* . 

□ Full vocabulary of Greek letters and special symbols, such as ‘gamma’ for y, 
‘GAMMA’ for r, ‘integral’ for J, and so on. 

□ Automatic calculation of large bracket sizes 

□ Vertical ‘piling’ of formulae for matrices, conditional alternatives, etc. 
o Integrals, sums, etc., with arbitrarily complex limits 

□ Diacriticals: dots, double dots, hats, bars, etc. 

□ Easily learned by nonptogrammers and mathematical typists. 

See Formatting Documents on the Sun Workstation and the eqn(l) manual page 
for further details. 

tbl is a preprocessor for nrof f and trof f that translates simple descrip- 
tions of table layouts and contents into detailed typesetting instructions 

□ computes column widths 

□ handles left- and right-justified columns, centered columns and decimal- 
point alignment 

□ places column titles 

□ table entries can be text, which is adjusted to fit 

□ can box all or parts of table. 

Here is a small example of the input for a table: 
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^^tart of table indicator 

options for the whole table 

. TS ^ —box means put a box around the whole table 

box tab (/) ; tab ( / ) means use / as the tab indicator 

cfBI w(0.4i) cfBI w(l.Oi) cfBI w(3.0i) 
cfBI w(0.4i) I Iw(l.Oi) | lw(3.0i). \ 

. sp 4p \ 

Revision/Date/Comments \ 



. sp 4p 
. sp 4p 

51/1 October 1985/T{ 

First release of this Manual. 
T) ~ ■ 

.sp 2.5i 
. sp 4p 



column specifications 



-Filled text block 



end of table indicator 



Here are the results of formatting the above table source: 



Revision 



Comments 



1 October 1985 First release of this Manual. 




See Formatting Documents on the Sun Workstation and the tbl(l) manual page 
for further details. 
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Bibliographic References 



15.4. Other Document 
Preparation Tools 



Handling Reverse Paper 
Motions 



refer is a bibliography system to support citations in documents. The refer 
system comprises a set of facilities for data entry, indexing, retrieval, sorting of a 
bibliographic database. 

There are some supporting utilities that make refer easier to use. addbib 
creates and extends the bibliographic database, sortbib sorts the bibliographic 
database by author, date, or lother criteria, and rof fbib can format the entire 
bibliographic database as a bibliography or aimotated bibliography. See Format- 
ting Documents on the Sun Workstation and the addbib(l), sortbib(l), 
rof fbib(l), indxbib(l), and lookbib(l) manual pages for further details. 

In addition to the major document preparation tools described above, there are a 
number of other minor supporting tools. 

spell is described in chapter 9 and can check the spelling of a document 
against an on-line dictionary. 

See Formatting Documents on the Sun Workstation and the spell(l) manual 
page for further details. 

col converts files with reverse line feeds into canonical form for one-pass print- 
ing. col is used mainly in conjunction with nrof f to deal with those printers 
that can’t do reverse paper motions. 

See Formatting Documents on the Sun Workstation and the col(l) manual page 
for further details. 



Stripping trof f Constructs derof f removes trof f requests from a source file. The spelling checker 

facility, among others, uses derof f to get rid of all the trof f requests which 
would otherwise show up as mis-spelled words. 

See Formatting Documents on the Sun Workstation and the derof f(l) manual 
page for further details. 

Checking Syntax checknr checks a document for possible mismatched opening and closing del- 

imiters and unknown trof f requests. The complexity of trof f requests and 
macro calls can sometimes lead to strange effects such as entire chunks of a 
document disappearing into a black hole. Such problems are often caused by, 
say, starting a display and forgetting to end it. 

checkeq checks a dociunent for correctly specified equations. 

See Formatting Documents on the Sun Workstation and the checknr(l) and 
checkeq(l) manual pages for further details. 

Generating a Permuted Index ptx generates a permuted, or keyword-in-context, index from text files. 

See Formatting Documents on the Sun Workstation and the ptx(l) manual page 
for further details. 

Interpreting trof f Output ptiisthe phototypesetter interpreter designed for those sites that need to exam- 

ine the codes that trof f generates destined for the C/A/T phototypesetter. The 
C/A/T phototypesetter requires a binary code whose format is complicated beyond 
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all belief, pt 1 displays a readable interpretation of these codes for those who 
are (say) writing software to convert C/A/T codes to other formats. 

See Formatting Documents on the Sun Workstation and the pt i(l) manual page 
for further details. 



15.5. Summary of Document Here is an alphabetical list of the document preparation utilities described in this 
Preparation Utilities chapter. 



Figure 15-2 Summary of Document Preparation Programs 



Program 

Name 



Function 



checkeq Check correctly specified equations 

checknr Check nrof f and trof f constracts 

col Filter out reverse paper motions 

derof f Strip out nrof f and trof f constmcts 

eqn Language for specifying mathematical equations 

-man Macro package to format the on-line manual pages 

-me Macro package derived from U. C. Berkeley 

-ms Popular macro package for technical memorandum 

nr o f f Document formatter oriented to typewriter-like devices 

pt i Interpreter for trof f output files 

pt X Generate permuted (keyword in context) index 

refer Bibliographic database processor 

spell Check spelling 

tbl Language for describing columnar layouts 

t r o f f Document formatter oriented to typesetter 
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Manuals You Should Read 



16.1. Setup and Installation 



Configuring the System 



System Administration 



System Administration is a whole collection of tasks that must be done to install 
new versions of the operating system and application software, keep the 
hardware and software running, troubleshoot, and upgrade. 

In general, you must be the super-user to manage the system. The super-user 
(also called root) has powers to override other users’ permissions and in general 
can wreak much havoc if out of control. 

System administration can be divided into these rough areas: 

□ Initially setting up the hardware and installing the software. 

□ Managing the system on a daily basis — adding new user accounts. 

□ Fixing things when they’re broken. Rebooting the system. 

□ Adding printers and terminals and making the system aware of their 
existence. 

When you receive your system you should read the Installation Manual to find 
out how to unpack and set up the hardware. 

Then the manual entitled Installing UNIX on the Sun Workstation is a guide to 
configuring the system using the setup utility mentioned below, and to instal- 
ling the UNIX operating system. 

Finally, System Administration for the Sun Workstation contains a collection of 
‘folklore’ that you need to manage the system. 

The manual pages for System Administration tasks can be found in the Com- 
mands Reference Manual for the Sun Workstation . 

Initial setup and installation of a Sun system is aided by a special program called 
setup, which is a menu and mouse based configuration program to help you 
create the correct configuration for your system, s et up 

Your system is delivered with a generic kernel — that is, the kernel is configured 
to drive every kind of device that Sun supports. The code for the devices drivers 
and their data structures occupies real memory. WTien you install your system, 
you can reconfigure the kernel to only include those drivers for your particular 
system, conf ig is the utility that creates the necessary files and commands to 



»sun 

Nr microsystems 



119 



A of 15 February 1986 




1 20 System Overview 



16.2. Startup and Shutdown 
Procedures 

Halting and Rebooting 
Checking File Systems 



16 J. Day to Day 

Adminstration Tasks 

Becoming Super User 
Changing Ownership of a File 

Scheduling Events 

Mounting and Unmounting File 
Systems 



configure the kernel, the procedure for reconfiguring the kernel is well described 
in Installing UNIX on the Sun Workstation . 

This system attempts to automate die boot procedures as much as possible. 

There are automatic boot procedures to bring up Sun UNIX. Automatic reboot 
and file consistency checks and repair in the event of system crash. 

The system normally boots itself automatically when power is turned on. How- 
ever, die super-user can shut down the system and reboot it at will. 

halt halts the system and returns control to the PROM monitor, 
reboot performs an automatic reboot. 

sync forces all outstanding I/O on the system to complete — used to shut down 
gracefully. 

£s ck is an interactive file system check and repair program, f sck is usually 
called into play automatically during the boot procedure. 

□ Display gross statistics: number of files, number of directories, number of 
special files, space used, and free space 

□ Report duplicate use of space 

□ Retrieve lost space 

□ Report inaccessible files 

□ Check consistency of directories 

□ List names of all files. 

f sck supersedes dcheck, icheck, and ncheck. 

Your Sun system must be administered on an ongoing basis. Some of the tasks 
you may n^ to do are described here. 

su changes your user ID so that you become the super-user temporarily with all 
the rights and privileges diereof. 

chown changes the ownership of one or more files. At times you may need to 
‘give a file away’ to someone else other than the original owner. This is usually 
true when you create a new account on the system. 

cron schedules regular actions at specified times 
a Actions are arbitrary programs 

□ Times are conjunctions of month, day of month, day of week, hour and 
minute — ranges may be specified for each. 

mount attaches a device containing a file system to the tree of directories, 
mount protects against nonsense arrangements. 

ximount removes the file system contained on a device from the tree of direc- 
tories. umount protects against removing a busy device. 
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Creating New File Systems 



Creating Special Files 



Dumping and Restoring Files 



16.4. System Accounting 
Facilities 



newf s createa a new file system on a device, newf s is actually a ‘front end’ to 
the mkf s command, but newf s does much more of the hard work for you. 

mkf s makes a new file system on a device. 

mknod makes a node (file system entry) for a special file. Special files are phy- 
sical devices, virtual devices, physical memory, etc. Special files generally 
reside in the /dev directory. 

tar manages file archives on magnetic tape 

p Collect files into an archive 

□ Update tape archive by date 
o Replace or delete tape files 

□ Display table of contents 
o Retrieve from archive. 

dump dumps the file system stored on a specified device, selectively by date, or 
indiscriminately. 

restore restores a dumped file system, or selectively retrieves parts thereof 

The UNIX system was originally a times-sharing system intended to support mul- 
tiple users on a single CPU. To this end there are facilities to perform accounting 
functions, a c publishes cumulative cormect time report. Connect time by user 
or by day and for all users or for selected users. 

sa publishes Shell accounting report: 

□ give usage information on each command executed, number of times used, 
total system time, user time and elapsed time, optional averages and percen- 
tages, and sorting on various fields 

□ note that the timing information on which the reports are based can be manu- 
ally cleared or shut off completely. 
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Sun Technical Documentation 



Sun Microsystems supplies a comprehensive package of documentation to sup- 
plement its hardware and software products. Much of the technical documenta- 
tion is completely new and describes products and package that Sun Microsys- 
tems have added to the original base of UNIX software. Other areas of the docu- 
mentation evolved from the original UNIX system manuals that were produced at 
Bell Laboratories and at University of California, Berkeley. The Technical Pub- 
lications group at Sun Microsystems have made extensive revisions and improve- 
ments to the original base. Sun Microsystems’ manuals are grouped into five 
document ‘families’ as shown in Figure 17-1. 
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Figure 17-1 Families of Technical Manuals 




Some families are oriented specifically to users , with the emphasis of using the 
existing base of applications software. In this category we group the User’s 
Manuals and the System Administration Manuals. 
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17.1. User’s Guides 



User guides in Sun Microsystems documentation look as in this picture 



Figure 17-2 Users Guides 
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17^. Beginner’s Guides 



There are a collection of Beginner’s Guides aimed at people who are new to the 
UNIX operating system and the Sun environment. These beginner’s guides are as 
shown in this picture: 



Figure 17-3 Beginner’s Guides 
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17 J. System Administration 
Guides 



Includes system installation, configuration, boot, and maintenance procedures, 
mail system and networking facility set-up information, and a reference manual 
for commands and utilities of use to system managers. 



Figure 17-4 System Administration Guides 
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17.4. Programming Manuals 
Figure 17-5 



17.5. Reference Manuals 

Commands Reference Manual 
for the Sun Workstation 



Programming manuals cover a number of distinct areas. The overall picture of 
programming documentation looks like this: 



Programming Manuals 




There are two major reference manuals in Sun’s suite of documentation: 

□ UNIX Interface Rrference Manual for the Sun Workstation 

o Commands Reference Manual for the Sun Workstation 

These two manuals were derived from the ‘man’ pages of the original UNIX sys- 
tem Programmer’ s Reference Manual . 

The Commands R^erence Manual is one of the two major r^erence manuals in 
the suite of documentation. The Commands Reference Manual is a ‘dictionary ’- 
oriented list of die coimnands that the user can type to the operating system. The 
Commands Reference Manual is oriented towards users using the everyday com- 
mands of the system to do work, and also to the system administrator managing 
the operation of the system. There are also descriptions of the public files and 
macro packages, plus a section on games and other trivial pursuits. 

The organization of the Commands Reference Manual follows loosely the ‘tradi- 
tional’ model of the UNIX system Programmer’s Reference Manual . 
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UNIX Interface Reference 
Manual for the Sun 
Workstation 



17.6. History of Sun 

Microsystems Manuals 



Bell Laboratories Manuals 



Berkeley Enhancements to the 
Manuals 



Problems with the UNIX 
Manuals 



The UNIX Interface Reference Manual is one of the two major reference manu- 
als in the suite of documentation. The UNIX Interface Reference Manual is a 
‘dictionary’ -oriented list of the programming interfaces to the operating system 
and applications libraries. The UNIX Interface Reference Manual is oriented 
towards programmers writing C-language programs. It contains descriptions of 
system calls, subroutines from various libraries, characteristics of special files 
(devices), and formats of files. 

The organization of the UNIX Interface Reference Manual follows loosely the 
‘traditional’ model of the UNIX system Programmer’ s Reference Manual . 

Here is a description of how Sun Microsystems’ technical manuals differs from 
the ‘traditional’ UNIX system documentation. We focus here on the problems 
that the marketplace perceives with ‘standard’ UNIX system documentation and 
what we at Sun Microsystems have done to correct this. 

Taking the Version 7 UNIX system as a starting point, the UNIX system manuals 
appeared in three books: 

□ The UNIX Programmer’ s Rrference Manual Volume 1 contained the ‘man’ 
pages — an eight-section manual containing an alphabetically ordered col- 
lection of pages describing various aspects of both the user (command) inter- 
face to the UNIX system and its utility software, and the programming inter- 
faces to the operating system and application libraries. 

□ The UNIX Programmer’ s Reference Manual Volume 2A contained a collec- 
tion of papers describing software to assist developing computer programs. 

□ The UNIX Programmer’ s Rrference Manual Volume 2B contained a collec- 
tion of papers describing text manipulation and document preparation tools. 

The Computer Science Research Group at the University of California at Berke- 
ley made many enhancements to the UNIX operating system. They also added 
The UNIX Programmer’ s Reference Manual Volume 2C containing papers on the 
ex and vi text editors, die Berkeley implementation of the Pascal programming 
language, the (now defunct) sdb debugger, and various papers on the document 
preparation tools including The Berkeley Font Catalog . The Berkeley group also 
added a huge number of new ‘man’ pages to reflect both new commands and new 
programming interfaces in the Berkeley UNIX system. 

When Sun Microsystems ‘inherited’ the Bell Laboratories and Berkeley UNIX 
system manuals we set out to improve the documentation in response to the prob- 
lems as users in the marketplace perceived them. Here are some of the criticisms 
that were heard: 

□ Installation and Administration instractions were largely non-existent — 
much of the necessary detail is scattered throughout a collection of 
apparently unrelated pages organized in alphabetical order. 

□ The system is inaccessible via the manuals. 
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Sun Microsystems Strategy 



Target Audience 



Evolution versus Revolution 



Functional Organization 



□ Almost impossible to find needed information in the UNIX manuals. Inade- 
quate motivation. Lack of locators (tables of contents, indexes). 

□ The marketplace levels strong criticism against companies who just copy the 
UNIX manuals and ship them without further change. 

□ The ‘man’ page paradigm is largely useless in a system attempting to 
describe user interfaces based on graphics and bit-mapped screens with 
menus and icons. 

We set out with the goal of producing high-quality user documentation to make 
the system easier to access. At the start we had to define our target audience — 
who are these manuals aimed at? 

Scientific and technical users with (possibly some) computer pro- 
gramming experience who are neither expert UNIX programmers nor 
expert UNIX users. We could assume a reasonable level of technical 
expertise on the part of our users and not feel that we had to write for 
the mass-market. 

The ramifications of having this kind of audience are that we could change the 
organization of the whole slew of UNIX manuals to bring them closer to what 
non-UNIX users would expect. The documentation must be addressed more 
specifically to users doing a day-to-day job, rather than towards users doing 
computer-science research for the benefit of other computer scientists. 

We resisted the strong temptation to trash the Bell Laboratories and Berkeley 
manuals and start over from scratch — that was seen as too big a step. We had to 
work with what was supplied and improve on that. We focused on making the 
manuals reflect the system as accurately as possible — truth first, beauty second. 
Our starting point was an incomplete version of 4.2 BSD so we were tracking a 
moving target 

Our first priority was a setup and installation guide for the Sun Workstation and 
the UNIX operating system miming on that hardware. This manual evolved over 
time into the current Installing UNIX on the Sun Workstation and System 
Administration for the Sun Workstation manuals. 

The secondary priority was to identify the logical ‘families’ into which the exist- 
ing and future documentation would fit and write the manuals to that model. The 
narrative material from the ‘man’ pages was to be moved into a series of ‘text- 
books’ organized in functional rather than alphabetically, leaving the ‘man’ 
pages as the terse reference dictionary they were originally intended to be. 
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Third Party Software 



Sun Microsystems’ success in the marketplace can be attributed in large measure 
to the number of third party software vendors that have implemented their spe- 
cialized application software to run on Sun systems. 

The third party program is an ongoing part of Sun’s marketing organization. At 
the time of writing (Autumn 1985) there are more than 350 third party vendors in 
the Catalyst program. Here are the major application areas as listed from the 
Catalyst catalog. For detailed information and people to contact, please refer to 
the appropriate section of the Catalyst catalog. 

□ Add on hardware. 

□ Architectural and Civil Engineering. 

□ Artificial Intelligence. 

□ Communications. 

□ Data Base Management Systems. 

□ Earth Resource Engineering. 

□ Electrical Engineering. 

□ Graphics. 

□ Mathematics and Statistics. 

□ Mechanical Engineering. 

□ Office Automation, 
o Software Engineering. 

□ Miscellaneous. 

18.2. Sun User Group The Sun User Group is an independent organization of individuals and institu- 

tions who share a common interest in Sun Workstations and related products. 

The Sun User Group encourage exchange of information between Sun Worksta- 
tion users and Sun Microsystems, and to collecting and disseminating tech- 
niques, software, documentation, procedures, and related interesting information. 
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Donated Software Tape 



The Sun User Group offer a distribution tape of donated software at a nominal 
charge. The software is contributed from (he user community and is not sup- 
ported by Sun Microsystems. Among the many items of software on the distri- 
bution tape can be found: 

□ Device Drivers for hardware products that are not a directly supported part 
of the Sun Workstation product family. 

□ Utilities diat run in the Sun Windows environment 

□ Conununications enhancements. 

□ Compilers for languages other than those thhat Sun Microsystems supports 
directiy. 

□ Editors and spreadsheets. 

□ Mail handlers. 

□ Games. 

□ System administration tools. 

You must be a member of the Sun User Group, and a Sun customer, to get a copy 
of the Donated Software Tape. 
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access permissions 
change, 50 

for files and directories, 47 
access remote machines — tip, 58 
accessing the system, 41 thru 43 
accounting, 121 
adb debug tool, 81 
administration, 119 thru 121 
system accounting, 121 
administration guides, 129 
application, 15 
ar — library maintainer, 82 
assembler programming language, 74 
at — schedule processes, 38 

B 

batch editor — sed, 63 
be desk calculator, 43, 86 
binary compare file, 52 
block hangups — nohup, 38 
block messages — mesg, 57 
Bourne Shell, 37 
browse through file, 52 
build programs — make, 84 

c 

C preprocessor — epp, 72 
C programming language, 72 thru 73 
cc — C compiler, 72 
epp — C preprocessor, 72 
indent — format C programs, 73 
lint — verify C programs, 72 
C shell, 16, 36 
calculators 
be, 43, 86 
dc, 42, 86 

calendar — reminder service, 42 

call-graph profile, 83 

caller process, 98 

cat — concatenate files, 52 

catalyst program, 135 

cc — C compiler, 72 

cd — change working directory, 50 

change 



change, continued 

access permissions, 50 
group, 50 
password, 41 
priority nice, 38 
working directory, 50 
check spelling — spell, 115 
checkeq, 115 

checking spelling in text files, 66 

checknr, 115 

checksum file, 53 

chgrp — change group, 50 

chmod — change access permissions, 50 

client machine, 15 

clocktool, 27 

emp — binary compare files, 52 

code coverage, 83 

col, 115 

command interpreter, 16 

at — schedule processes, 38 
Bourne Shell, 37 
C SheU, 36 

echo — echo arguments, 37 
expr — evaluate expressions, 38 
kill — kill process, 38 
nice — change priority, 38 
nohup — block hangups, 38 
sleep — suspend process, 38 
tee — divert output, 38 
test — test arguments, 37 
wait — wait on process, 38 
command interpreters, 35 thru 38 
communications, 57 thru 58 
local, 57 
mail, 57 
mesg, 57 
remote, 58 
talk, 57 
tip, 58 
uucp, 58 
write, 57 

compare file (binary), 52 

compiler development tools, 84 thru 85 

concatenate files, 52 

convert data formats of file, 53 

copy 

directories, 52 
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copy, continued 
files, 52 

counting things in text files, 63 
cp — copy files, 52 
creating 

cursors or icons, 25 
directory, 50 

fonts with — f ontedit, 29 
links to files, 51 
current directory, 48 
display name of, 50 
cursors 

creating with iconedit, 25 

D 

data formats 
convert, 53 

date — display date and time, 42 
dbx debug tool, 81 
dbxtool, 26 
dbxtool debug tool, 79 
dc desk calculator, 42, 86 
dd — convert file formats, 53 
decrypting text files, 66 
def aultedit, 31 
defaults 

editing with def aultedit, 31 
deleting 

directory, 50 
files, 51 
deroff, 115 
desk calculators 
be, 43, 86 
dc, 42, 86 

determine type of file, 51 
device-independent I/O, 97 
df — display free space, 51 
directory, 47, 47 thru 53 
access permissions, 47 
change access permissions, 50 
change working, 50 
copy, 52 
creating, 50 
current, 48 

display name of working, 50 
displaying names of, 49 
home, 48 
linking to, 51 
move, 50 
remote copy, 52 
removing, 50 
rename, 50 
working, 48 
display 

commonality between text files, 66 
date and time, 42 
differences between text files, 65 
head of file, 53 

name of working directory, 50 
namelist — nni, 82 
size of object size, 82 
tail of file, 53 



display, continued 

time — clocktool, 27 
usage of file system, 51 
display editor — vi, 62 
divert output — tee, 38 
document preparation, 109 thru 1 16 
checkeq, 115 
checknr, 115 
col, 115 
deroff, 115 
eqn, 112 

macro packages. 111 

-man macro package, 112 

-me macro package, 112 

-ms macro package, 1 12 

nroff. 111 

pti, 115 

ptx, 115 

refer, 115 

spell, 115 

tbl, 113 

troff. 111 

documentation, 125 thru 132 

history and evolution, 131 thru 132 
programming manuals, 130 
reference manuals, 130 thru 131 
system administration guides, 129 
user’s guides, 127 thru 128 
donated software tape, 136 
du — display disk usage, 51 
dump file — od, 82 

E 

echo — echo arguments, 37 
editing 

defaults — def aultedit, 31 
fonts — font edit, 29 
text — text edit, 28 
editing text files, 62 thru 63 
ed, 63 
ex, 63 
sed, 63 
Vi, 62 

electronic mail — mail, 57 
encrypting text files, 66 
eqn, 112 

equation formatting — eqn, 1 12, 1 15 
erasing 

directory, 50 
files, 51 

evaluate expressions — expr, 38 
evolution and history of manuals, 131 thru 132 
execution profile, 83 
expr — evaluate expressions, 38 
expression evaluation — expr, 38 
External Data Representation, 98 

F 

file,47,47«/in<53 

access permissions, 47 
binary compare, 52 
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change access permissions, 50 
checksum, 53 
convert data formats, 53 
determine type of, 51 
display head of, 53 
display tail of, 53 
page through, 52 
split, 53 

file — find file type, 51 
file dump — od, 82 
file system, 13 

directory, 47 thru 53 
display usage, 51 
file, 47 thru 53 
networic, 14 
remote mounting, 14 

files 

concatenate, 52 
copy, 52 
deleting, 51 

displaying names of, 49 
erasing, 51 
finding, 51 
linking to, 51 
move, 50 
remote copy, 52 
removing, 51 
rename, 50 
find — find files, 51 
finding 

files, 51 

what people are doing, 42 
who is logged in, 42 
f ontedit, 29 
fonts 

editing with f ontedit, 29 
format C programs — indent, 73 
format conversion 
for files, 53 

formatting documents, 109 thru 116 
checkeq, 115 
checknr, 115 
col, 115 
deroff, 115 
eqn, 112 

macro packages. 111 
-man macro package, 1 12 
-me macro package, 112 
-ms macro package, 112 
nroff. 111 

pti, 115 
ptx, 115 
refer, 115 
spell, 115 
tbl, 113 
troff. 111 

FORTRAN programming language, 73 
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gaining access, 41 

generate lexical analyzer — lex, 85 
generate syntax analyzer — yacc, 85 
gprof — call-graph profile, 83 
graphics tools, 91 thru 92 
Pixrect, 92 
SunCGI, 92 
SunCore, 91 
SunGKS, 92 
group 

change, 50 

H 

hardware products, 7 thru 10 
head — display head of file, 53 
head of file 
display, 53 

hierarchical file system, 13 

history and evolution of manuals, 131 thru 132 

history keeping — s c c s , 84 

home directory, 48 

I 

iconedit, 25 
icons 

creating with iconedit, 25 
interactive 

debugging with dbxtool, 26 
interactive co mman d interpreter, 16 
interactive line editor — ed, 63 
interactive line editor — ex, 63 
interactive screen editor — vi, 62 
interprocess communication, 98 

J 

job control, 97 

K 

kill process — kill, 38 

L 

languages, 71 thru 74 
adb debug tool, 81 
assembler, 74 
C, 72 thru 13 
cc — C compiler, 72 
cpp — C preprocessor, 72 
dbx debug tool, 81 
dbxtool debug tool, 79 
FORTRAN, 73 

gprof — call-graph profile, 83 
indent — format C programs, 73 
link editor, 74 

lint — verify C programs, 72 
object code tools, 77 thru 87 
Pascal, 73 

performance analysis, 83 thru 87 
prof — execution profile, 83 
Ratfor, 73 

t cov — code coverage/statement analysis, 83 



- 139 - 




Index Continued 



languages, continued 

t ime — time program execution, 83 
lexical analyzer generators, 84 thru 85 
lexical generator — 1 ex, 85 
library maintainer — ar, 82 
line editor 
ed, 63 
ex, 63 

link editor, 74 
linking to 

directories, 51 
files, 51 

In — make links to file, 51 
local communications, 57 
mesg, 57 
talk, 57 
write, 57 
logging in, 41 
logging out, 41 

login — log in to system, 41 
logout — log out from system, 41 
Is — display file and directory names, 49 

M 

m4 macro processor, 86 
machine products, 7 thru 10 
macro packages for document preparation, 111 
-man, 112 
-me, 112 
-ms, 112 

mail — electronic mail, 57 
mailtool, 30 
maintain history — s cc s, 84 
maintain library — ar, 82 
maintain programs — make, 84 
make program maintainer, 84 
-man macro package, 1 12 
manuals, 125 thru 132 

history and evolution, 131 thru 132 
programming manuals, 130 
reference manuals, 130 thru 131 
system administration guides, 129 
user’s guides, 127 thru 128 
manuscript preparation, 109 thru 116 
checkeq, 115 
checknr, 115 
col, 115 
deroff, 115 
eqn, 112 

macro packages. 111 

-man macro package, 1 12 

-me macro package, 112 

-ms macro package, 112 

nroff. 111 

pti, 115 

ptx, 115 

refer, 115 

spell, 115 

tbl, 113 

troff. 111 

mathematical typography — eqn, 112, 115 



-me macro package, 112 
mesg — block messages, 57 
mkdir — create directory, 50 
mode 

change, 50 

of files and directories, 47 
more — page through file, 52 
mouse, 21 
move 

directories, 50 
files, 50 

-ms macro package, 1 12 
mv — more (rename) file, 50 

N 

network communication, 98 
network file system, 14 
networking, 97 
nice — change priority, 38 
nm — display namelist, 82 
nohup — block hangups, 38 
nroff. 111 

o 

object code tools, 77 thru 87 
od — dump file, 82 
offline printing — Ipr, 62 
operating system, 13 thru 17, 95 thru 99 

p 

page through file, 52 
parser generator — yacc, 85 
parser generators, 84 thru 85 
Pascal programming language, 73 
pas swd — change password, 41 
password, changing, 41 
patterns 

scanning for in text files, 64 
performance analysis, 83 thru 87 
gprof — call-graph profile, 83 
prof — execution profile, 83 
tcov — code coverage/statement analysis, 83 
time — time program execution, 83 
Pixrect, 92 
printing text files, 62 
printing text files — Ipr, 62 
printing text files — pr, 62 
process 

block hangups — nohup, 38 
change priority — nice, 38 
divert output — tee, 38 
kill process — kill, 38 
schedule processes — at, 38 
suspend — sleep, 38 
wait, 38 

prof — execution profile, 83 
programming languages, 71 thru 74 
adb debug tool, 81 
assembler, 74 
C, 72 thru 73 
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programming languages, continued 
cc — C conq)iler, 72 
cpp — C preprocessor, 72 
dbx debug tool, 81 
dbxtool debug tool, 79 
FORTRAN, 73 

gprof — call-graph profile, 83 
indent — format C programs, 73 
link editor, 74 

lint — verify C programs, 72 
object code tools, 77 //itm 87 
Pascal, 73 

performance analysis, 83 thru 87 
prof — execution profile, 83 
Ratfor, 73 

tcov — code coverage/statement analysis, 83 
time — time program execution, 83 
programming manuals, 130 
programming tools, 77 thru 87 
ar — maintain library, 82 
be desk calculator, 86 
compiler development, 84 thru 85 
dc desk calculator, 86 
lex — lexical generator, 85 
m4 macro processor, 86 
make program builder, 84 
nm — display namelist, 82 
od — dump file, 82 
sees history keeper, 84 
size — display size of object, 82 
strings — search for strings, 82 
strip — strip symbol table, 82 
yaee — parser generator, 85 
ps — display process status, 42 
pti, 115 
ptx, 115 

pwd — display name of working directory, 50 

R 

Ratfor programming language, 73 
rep — remote copy files, 52 
refer, 115 

reference manuals, 130 thru 131 
regular expressions, 62 
reminder service — calendar, 42 
remote communications, 58 
tip, 58 
UUCP, 58 

remote copy directories, 52 

remote copy files, 52 

remote file transfers — uucp, 58 

remote login, 42 

Remote Procedure Call, 98 

remote shell, 42 

remotely mounted file systems, 14 
removing 
files, 51 

removing directory, 50 
rename 

directories, 50 
files, 50 



rlogin — remote login, 42 
r m — remove file, 5 1 
rmdir — remove directory, 50 
RPC, 98 

r sh — remote shell execution, 42 

s 

scanning for patterns in text files, 64, 65 
secs history maintainer, 84 
schedule processes — at, 38 
screen editor — vi, 62 
search for strings — strings, 82 
server machine, 15 
server process, 98 
shell, 16 

Shell-related utilities 

at — schedule processes, 38 
echo — echo arguments, 37 
expr — evaluate expressions, 38 
kill — kill process, 38 
nice — change priority, 38 
nohup — block hangups, 38 
sleep — suspend process, 38 
tee — divert output, 38 
test — test arguments, 37 
wait — wait on process, 38 
Shells, 35 thru 38 
Bourne Shell, 37 
C Shell, 36 
signing off, 41 
signing on, 41 

size — display size of object, 82 
sleep — suspend process, 38 
sockets, 98 

software development tools, 77 thru 87 
ar — maintain library, 82 
be desk calculator, 86 
coirq)iler development, 84 thru 85 
dc desk calculator, 86 
lex — lexical generator, 85 
m4 macro processor, 86 
make program builder, 84 
nm — display namelist, 82 
od — dump file, 82 
secs history keeper, 84 
size — display size of object, 82 
strings — search for strings, 82 
strip — strip symbol table, 82 
yaee — parser generator, 85 
sorting text files, 64 
source code control system, 84 
spell, 115 
spelling checker, 66 
split — split file, 53 
split file, 53 

spooling text files — Ipr, 62 
statement analysis, 83 
stream editor — sed,63 
strings — search for strings, 82 
strip — strip symbol table, 82 
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strip symbol table — strip, 82 

sum — checksum file, 53 

Sun user group, 135 

SunCGI, 92 

SunCore, 91 

SunGKS, 92 

SunView, 21 thruZl 

clocktool — display time, 27 
dbxtool — interactive debugging, 26 
default edit — setting up defaults, 31 
font edit — create fonts, 29 
iconedit — edit icons and cursors, 25 
mailtool — read mail, 30 
shell tool — shell interface, 24 
text edit — text editing, 28 
super-user, 119 

suspend process — sleep, 38 
symbol-table display — nm,82 
syntax analyzer generators, 84 thru 85 
system administration, 119 thru 121 
system accounting, 121 
system administration guides, 129 

T 

table formatting — tbl, 113 
tail — display tail of file, 53 
tail of file 

display, 53 

talk — talk to user, 57 
tbl, 113 

tcov — code coverage/statement analysis, 83 
technical documentation, 125 thru 132 
history and evolution, 131 thru 132 
programming manuals, 130 
reference manuals, 130 thru 131 
system administration guides, 129 
user’s guides, 127 thru 128 
tee — divert output, 38 
test — test arguments, 37 
text 

editing with textedit, 28 
text files 

checking spelling — spell, 66 

counting things — wc, 63 

display differences between — di f f , 65 

displaying commonality — comm, 66 

editing, 61 thru 67 

editing — ed, 63 

editing — ex, 63 

editing — sed, 63 

editing — vi, 62 

encrypting — crypt, 66 

printing, 62 

printing — Ipr, 62 

printing — pr, 62 

processing, 61 thru 67 

scanning for patterns — awk, 65 

scanning for patterns — egrep, 64 

scanning for patterns — f grep, 64 

scanning for patterns — grep, 64 

sorting — sort, 64 
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translating characters — wc, 64 
text patterns, 62 
textedit, 28 
third-party software, 135 
time — time program execution, 83 
time of day 
display, 42 

displaying with clocktool, 27 
tip — access remote machines, 58 
translating characters in text files, 64 
troff, 111 
type of file 

determine, 51 

u 

user, 15 

user access, 41 thru 43 
user environment, 21 thru 31, 103 thru 105 
clocktool, 27 
dbxtool, 26 
defaultedit, 31 
f ontedit, 29 
iconedit, 25 
mailtool, 30 
shelltool, 24 
textedit, 28 
user group, 135 
user guides, 127 thru 128 
user interface, 16 
user manuals, 125 thru 132 
UUCP — access remote machines, 58 

v 

verify C programs — lint, 72 

virtual memory, 97 

visual text editor — vi, 62 

w 

w — what are people doing, 42 
wait on process — wait, 38 
who — whos is logged in, 42 
window system, 16, 21 thru 31, 103 thru 105 
clocktool, 27 
dbxtool, 26 
defaultedit, 31 
f ontedit, 29 
iconedit, 25 
mailtool, 30 
shelltool, 24 
textedit, 28 
working directory, 48 
display name of, 50 
workstation products, 7 thru 10 
write — write to user, 57 
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